2.4. File Operations
- The command supports one parameter that allows to force a viewing mode(Beta version) (in this case, plugins will be ignored, but you can switch the mode later in the viewer window). + The command supports one parameter that allows to force a viewing mode (in this case, plugins will be ignored, but you can switch the mode later in the viewer window). See the description of the modes on this page.
| mode | text | -Show as Text | +show as Text |
| bin | -Show as Bin | +show as Bin | |
| hex | -Show as Hex | +show as Hex | |
| dec | -Show as Dec | +show as Dec |
@@ -1043,8 +1043,20 @@
2.5. Configuration
- The plugin filename can be passed as a parameter. +
+ 1) Select a plugin file and Double Commander will automatically detect its type (WCX, WDX, WFX, WLX or DSX), open the required settings section and add it to the list.
+ 2) Select the archive that contains the plugin and a special file pluginst.inf (the plugin file and pluginst.inf must be located in the root of the archive): + the content of the archive will be extracted to the appropriate directory, the plugin will be added to the settings and Double Commander will open the corresponding settings section. If settings are stored in the user profile, Double Commander will use the "plugins" folder in the user's directory: +
-
+
- Windows XP: C:\Documents and Settings\<UserName>\Local Settings\doublecmd\plugins +
- Windows Vista/7+: C:\Users\<UserName>\AppData\Local\doublecmd\plugins +
- Unix-like OS: /home/<UserName>/.local/share/doublecmd/plugins +
+
+ Note: The first method of adding plugins requires to first place the files in a suitable location, however, in this case, Double Commander will report an error if the plugin could not be loaded (for example, if the operating systems does not contain the necessary libraries).
+
+ Filename can be passed as a parameter.
2.6. Network
- 2.7. Miscellaneous
- 
- cm_SaveFileDetailsToFile(Beta version) |
+
Save all shown columns of selected items to file. You may specify the output filename into the first parameter. If no parameter is supplied, Double Commander will prompt user to enter one. |
@@ -1506,17 +1518,38 @@ 
Ctrl+Shift+C |
- Copy item full names to clipboard. | +Copy item full names to clipboard. + One parameter is available, we can specify the preferred directory separator: + +
|
||||||||||||
|
- Will copy the full path of the current selected items including an ending directory separator. | +Will copy the full path of the current selected items including an ending directory separator. + One parameter is available, we can specify the preferred directory separator, see the description of cm_CopyFullNamesToClip. |
||||||||||||||
|
- Will copy the full path of the current selected items excluding an ending directory separator. | +Will copy the full path of the current selected items excluding an ending directory separator. + One parameter is available, we can specify the preferred directory separator, see the description of cm_CopyFullNamesToClip. |
||||||||||||||
@@ -2516,12 +2549,12 @@ 2.16. Tabs | ||||||||||||||||
- cm_MoveTabLeft(Beta version) |
+
Move current tab to the left. | |||||||||||||||
- cm_MoveTabRight(Beta version) |
+
Move current tab to the right. | |||||||||||||||
+
+ Ctrl+Shift+A |
+ Show a menu with a list of all open tabs. + +
|
+ |||||||||||||||
1. Presentation
An alternative form is also possible like this one:
doublecmd.exe [-C] [-T] [-P L|R] [-L path1\subpath1] [-R path2\subpath2]
+
Note: macOS command line has a some specificity, use the open command with the full application name ("Double Commander" with -a) and --args to pass parameters. For the second and subsequent instances, add -n.
1. Configuration files
The main files are:
doublecmd.xml – all the main program settings;
- doublecmd.cfg(Beta version) – settings that are applied before initialization of all program components and loading doublecmd.xml;
+ doublecmd.cfg – settings that are applied before initialization of all program components and loading doublecmd.xml;
extassoc.xml – file extension association configuration;
favoritetabs.xml – favorite tabs;
pixmaps.txt – maps file extensions to MIME-types icon names;
multiarc.ini – external archivers;
shortcuts.scf – keyboard layout settings;
- highlighters.xml – editor color settings;
+ colors.json – all color settings, Double Commander stores color values in the "Light" and "Dark" profiles and selects the profile automatically depending on the current theme (light or dark theme);
+ tabs.xml – list of opened tabs;
history.xml – command line and directory history, search and replace, etc.;
few others... – etc...
The configuration version in doublecmd.xml defines the data storage format: if it has changed in the new version of the program (for example, new parameters have been added or existing ones have changed), then at the first start Double Commander will update the configuration files. The upgrade process will back up the previous version of doublecmd.xml.(Beta version)
+The files are generated automatically, except for multiarc.ini and pixmaps.txt: they are included in the distribution of Double Commander (in the "default" folder) and are copied to the directory of configuration files when the program is first launched.
+The configuration version in doublecmd.xml defines the data storage format: if it has changed in the new version of the program (for example, new parameters have been added or existing ones have changed), then at the first start Double Commander will update the configuration files. The upgrade process will back up the previous version of doublecmd.xml.
2. Configuration
-The "Options" window allows to set almost all of the options in Double Commander, but there are several parameters that can only be changed manually in the doublecmd.xml configuration file. A filter by parameter name is available at the bottom of the window: the program will display only those sections that contain a matching parameter.(Beta version)
-To open the corresponding section in the program help, you can use the Help button or the F1 key.(Beta version)
+The "Options" window allows to set almost all of the options in Double Commander, but there are several parameters that can only be changed manually in the doublecmd.xml configuration file. A filter by parameter name is available at the bottom of the window: the program will display only those sections that contain a matching parameter.
+To open the corresponding section in the program help, you can use the Help button or the F1 key.
Double Commander has several internal commands to open the configuration dialog and quickly jump to the desired section.
Double Commander supports importing/exporting some settings: directory hotlist, favorite tabs, external archivers, toolbar (main and middle), tooltips. Also, the list of hotkeys can be saved to a new file and you can switch between them.
Note: To the right of the file or directory choose buttons is the button Some functions to select appropriate path 
: the popup menu contains lists of variables (including environment variables) and some additional functions, see description here.
2. Configuration
-
Almost all parameters and switches are available in the window of built-in viewer, there are only two groups of parameters in this section.
-
There are two groups of parameters in this section:
+
The first group allows you to specify an external program for viewing files. Double Commander will automatically add the full filename as the last launch parameter each time the viewer is called.
Additionally: Execute in terminal and Keep terminal window open after executing program can be useful if you are using a console program and/or if the program's terminal output is important (or just temporarily for debugging).
-The next group of parameters, Viewer Book Mode, is associated with a special text viewing mode: you can set the font color, background color and the number of columns of text (like a book spread or a newspaper).
+The next group of parameters is Internal viewer options, however almost all parameters and switches are available in the window of built-in viewer.
+Number of columns in book viewer – see description of this mode here.
There are also several parameters available that can only be changed manually in the doublecmd.xml configuration file.
@@ -199,8 +202,9 @@
2. Configuration
Use spaces instead tab characters – Converts tab characters to a specified number of space characters (when entering).
Tab indents blocks – If enabled, Tab and Shift+Tab act as block indent, unindent when text is selected.
Smart Tabs – When the Tab key is used, caret will go to the next non-space character of the previous line.
+Group Undo – If enabled, all continuous changes of the same type will be processed in one call to the undo or redo command, instead of undoing/redoing each individual text change.
Tab width – The width of the tab character (in number of characters). If Use spaces instead tab characters is enabled, then the Tab key will insert the specified number of space characters. This setting does not apply if the Smart Tabs option is enable.
-Block indent(Beta version) – sets the number of characters by which the indent will increase or decrease when using the corresponding commands.
+Block indent – sets the number of characters by which the indent will increase or decrease when using the corresponding commands.
Right margin – Line length marker, thin vertical line at the given position: lines will not be truncated with a forced line break, it is just a visual hint. Useful in cases where there is a recommendation to limit the length of strings (for example, 80 or 120 characters).
@@ -216,7 +220,7 @@
2. Configuration
You can change the text and background colors and font style (underline, bold, italic and strike out) used for keywords, strings, numbers, operators, and so on. For the default text, only the text and background colors are available.
Text-mark is used to add a border around the element: you can choose the color, the type of border and the type of line.
Use (and edit) global scheme settings and Use local scheme settings are for default text only: you can change the colors for all file types at once, or only for some.
-All settings are saved in the highlighters.xml file.
+All settings are saved in the colors.json file.
Note: Possible ways to change (fix or improve) parsing of files (syntactic analysis), keyword lists, and so on:
- suggest changes to the Lazarus project (the best way); @@ -245,7 +249,7 @@
Windows: cmd.exe
- macOS(*): /Applications/Utilities/Terminal.app
+ macOS: Double Commander will automatically detect the program specified in the system settings.
Linux and other Unix-like systems:
For Debian and Debian-based distributions (antiX, Devuan, Ubuntu, Linux Mint and others), x-terminal-emulator will be used: this is a symbolic link to the terminal used in these systems by default.
@@ -273,13 +277,34 @@
2. Configuration
-2.5. Colors(Beta version)
-Dark mode – enables or disables dark mode support (only Windows 10 1809 and newer):
+ +This section contains color settings that are not included in other settings sections. The parameters are grouped by category.
+
+
1. Dark mode – enables or disables dark mode support (only Windows 10 1809 and newer). State:
Auto – system settings will be used.
Enabled – enable forcibly.
Disabled – disable forcibly.
2. Viewer – color settings that are used by the built-in file viewer (see description of viewing modes here):
+Book Mode – for the "Book" viewing mode, you can set the text color and background color.
+Image Mode:
+-
+
Background 1: – sets the background color of the window when viewing images.
+ Background 2: – if Show transparency is enabled, the internal viewer indicates transparency using a checkerboard pattern as background and Background 2 defines the color of the squares. If not set, the viewer will automatically calculate the value: for a dark background, light squares will be used and vice versa.
+
3. Differ – for the internal Differ tool: you can change the colors for added, deleted and modified lines, and the color for different characters in binary mode.
+4. Log – options that set the text colors in the log window for informational messages, error messages, and messages about successful operations. Also, these colors are used in the window with the result of verifying checksums.
+5. Synchronize Directories – for the internal directory synchronization tool:
+-
+
Left: – files selected for copying or deleting on the left.
+ Right: – files selected for copying or deleting on the right.
+ Unknown: – files with the same names, but not identical.
+
6. Drive Free Space Indicator – here you can change the appearance of the drive free space indicator:
+
+
Double Commander can display a gradient (from green to red) or simple monochrome indicator, in the second case you can choose the color and background. Indicator Threshold Color will be used if the free disk space is less than 10%.
+The indicator example is clickable, so you can see how it will look.
@@ -291,9 +316,12 @@2. Configuration
Use Inactive Sel Color – enables the display of the cursor also in the inactive panel.
Use Frame Cursor – Double Commander will use a frame instead of a solid rectangle.
Allow Overcolor enables the ability to use a color other than the default color for file names (see section Colors > File types).
-Also here you can decrease the brightness of the inactive panel and change the appearance of the drive free space indicator. Double Commander can display a gradient (from green to red) or simple monochrome indicator, for a monochrome indicator you can choose the color and background. Indicator Threshold Color(Beta version) will be used if the free disk space is less than 10%. The indicator example is clickable, so you can see how it will look.(Beta version)
+In the Current Path parameter group, you can change the text color and background color of the current directory bar for the active and inactive file panel.
+Also here you can decrease the brightness of the inactive panel.
There is a preview area at the bottom of the window, so you can see all the changes at once.
The Reset to DC default button will reset all parameters to their default values.
+The grid color can also be changed, but only manually. You need to close the application, open the colors.json file and replace the value of the
GridLinekey in theFilePanelobject. (Don't forget that the colors in colors.json are stored in two profiles: "Light" for light themes and "Dark" for dark themes.)
+ About color format: Double Commander stores color values in the$BBGGRRformat as a decimal number. For example, if you want to use the indigo color#4B0082($RRGGBB), then do the rearrangement, you will get82004Band now you need to convert this hexadecimal number to decimal. Or you can temporarily add a color for some type of file (see below), find it in colors.json by name or mask, copy the value and delete.
@@ -335,7 +363,7 @@2. Configuration
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.
+You can use a color from the list or specify yours using the ".." button.
Do not forget to click "Apply" button after customization.
Double Commander checks the list from top to bottom until the first match: a rule higher in the list will overlap any rule below.
@@ -493,12 +521,15 @@2. Configuration
nnminute (leading zero) 06 ssecond 2 second (leading zero) 02 milliseconds * 1 zzzmilliseconds (leading zero) * 001 tshort time format 9:06 ttlong time format 9:06:02 am/pmuse 12 hour clock and display am and pm accordingly (also AM/PM, a/m or A/M); for example, t AM/PM9:06 am /insert date separator / :insert time separator : literal text; for example, yyyy "AD"2021 AD * Windows only The next parameters sets the file size format:
@@ -554,8 +585,9 @@2. Configuration
Cut text to column width – Sometimes column text can overlap into other columns. This option truncates any extra text at the column boundary.
@@ -593,7 +625,7 @@ GETFILEEXT – file extension (from the dot to the end, e.g. txt).
GETFILESIZE – file or directory size. By default, the appearance will depend on the option chosen in the Files views section, but all possible size formats are also available.
GETFILETIME – file or directory modification date. The appearance will depend on the option chosen in the Files views section.
- GETFILECREATIONTIME – file or directory creation date (does not work in Linux/BSD, POSIX limitation).
+ GETFILECREATIONTIME – file or directory creation date.
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). For a detailed description of the string value, see here.
@@ -649,7 +681,7 @@ Add – opens the file selection dialog. Alternatively, you can use the internal command cm_AddPlugin.
+ Add – opens the file selection dialog. Alternatively, you can use the internal command cm_AddPlugin (also plugins can be installed automatically).
Disable – allows to temporarily disable the selected plugin.
Remove – removes the selected plugin from the list (but not plugin file!).
@@ -689,7 +721,7 @@
2. Configuration
2.10.3. Layout > Tree View Menu Colors
Here you can customize the appearance of the menu to your preference, a preview will show all changes before saving.
-
+
2.11. Toolbar and Toolbar > Toolbar Middle
@@ -786,7 +818,7 @@2. Configuration
When restoring tab, existing tabs to keep: – i.e. the Favorite Tabs will be added to the already open tabs.
Program directory (portable version).
+ The "settings" folder in the program directory (portable version).
User home directory.
ANSI – default system ANSI encoding (depends on the system locale).
+ OEM – default system OEM (DOS) encoding (depends on the system locale).
+ {!TERMSTAYOPEN} – run in terminal and stay open at the end;
{!TERMANDCLOSE} – run in terminal and request to close it at the end.
Default context actions (View/Edit)(Beta version) – Commands for opening a file in the viewer and editor. Built-in tools or external applications will be used (depending on the settings), internal file associations will be ignored.
+ Default context actions (View/Edit) – Commands for opening a file in the viewer and editor. Built-in tools or external applications will be used (depending on the settings), internal file associations will be ignored.
Run using macros {!SHELL}, {!TERMANDCLOSE} and {!TERMSTAYOPEN} (see details here):
Execute via shell
diff --git a/doc/en/configxml.html b/doc/en/configxml.html
index 7e883ba2..16c09081 100644
--- a/doc/en/configxml.html
+++ b/doc/en/configxml.html
@@ -56,9 +56,8 @@
3. Options to change manually
So generally, we don't have to manually edit the content of the configuration file.
But there are some very rare specific settings that required to be edited manually from the configuration file if we want to tweak the application.
-WARNING: We will not edit that file WHILE Double Commander is running! Not only because anyway their values are read only when we're starting the application, but also because if we edited the file while DC is running, when we'll close the application the values we would have wrote will be overwritten by the application re-saving its current context for next session. If we need to edit the doublecmd.xml file, we need to make sure we close Double Commander, then we edit file, and then we re-launch the application.
-
-About color format: We can set color as hex number using format
+$BBGGRR. For example, if we want to use the indigo color#4B0082, we would write$82004B.WARNING: We will not edit that file WHILE Double Commander is running! Not only because anyway their values are read only when we're starting the application, but also because if we edited the file while DC is running, when we'll close the application the values we would have wrote will be overwritten by the application re-saving its current context for next session. If we need to edit the doublecmd.xml file, we need to make sure we close Double Commander, then we edit file, and then we re-launch the application.
+ There is an alternative solution, see more details here (but to apply changes to some parameters, you may still need to restart the application).
The following table gives us these rare specific settings that we need to manually edit the file if we need to change them.
@@ -121,7 +120,7 @@3. Options to change manually
2. Configuration
Default values:
The screenshots below illustrate this subtle grid effect. The screenshot on the left has the vertical and horizontal lines enabled and the screenshot on the right does not.
It is possible to change the color of the lines, see more details here.
Auto fill columns – If enabled, when resizing the window (or if free space exists), Double Commander will resize the column, which selected in the next option Auto size column: (first or last). The horizontal scrollbar will not be available.
-Column titles alignment like values(Beta version) – If enabled, Double Commander will align the column header the same as the content (instead of left-aligned).
+Column titles alignment like values – If enabled, Double Commander will align the column header the same as the content (instead of left-aligned).
If the content of the column is larger than its width:
2. Configuration
2. Configuration
Search plugins are Double Commander's own plugin type, these plugins use console programs to find files (for example, Locate, Everything or Recoll). The DSX plugins interface allows to send them search parameter values from the "Standard" and "Advanced" tabs.
Buttons:
-
-
The following values are available for each parameter: Left, Right, Active, Inactive, Both or None.
-Keep saving dir history with Favorite Tabs – enables or disables saving the history of each tab.
+Keep saving dir history with Favorite Tabs – enables or disables saving the history of visited directories for each tab.
Also you can apply these parameters separately for each tabs set.
Default position in menu when saving a new Favorite Tabs – determines the order of adding a new set:
-
@@ -808,14 +840,14 @@
2. Configuration
-
Location of configuration files – Here you can choose where to store all configuration files (also you can see the full path here):
-
-
As an indicator, Double Commander uses an empty doublecmd.inf file in the program directory: - if the file exists, Double Commander will load configuration files from the program directory and save them here, otherwise Double Commander will use the current user's folder. +
As an indicator, Double Commander uses an empty doublecmd.inf file in the "settings" folder in the program directory: + if the file exists, Double Commander will load configuration files from the "settings" folder and save them here, otherwise Double Commander will use the current user's folder. You can manually add the doublecmd.inf file and get a portable version, or delete it by switching the storage method to the user's folder.
If you launch Double Commander with the --config-dir parameter, then DC will just write Set on command line and show the full path to the configuration files.
To quickly navigate to the directory with configuration files, you can use the Special Dirs submenu in the Directory Hotlist menu or use the %DC_CONFIG_PATH% variable.
@@ -856,11 +888,16 @@2. Configuration
This section contains parameters for which there was no suitable place in other sections of the settings:
-
Show splash screen(Beta version) – If enabled, before displaying the main window, Double Commander will show a splash screen containing the program icon and version, compilation date, and the version of Lazarus, FPC, and operating system.
+
Show splash screen – If enabled, before displaying the main window, Double Commander will show a splash screen containing the program icon and version, compilation date, and the version of Lazarus, FPC, and operating system.
Show warning messages ("OK" button only) – shows warning messages if enabled. (For example, if Double Commander cannot set some property or attribute of a file due to file system restrictions in the target directory.)
Always go to the root of a drive when changing drives – If unchecked, Double Commander will go to the last open directory on this drive (in this case, you can go to the root directory of the drive by pressing its button twice).
Show current directory in the main window title bar – If enabled, Double Commander will display the name of the current folder and the active panel path in the main window title bar.
+Default single-byte text encoding: – By default (NONE), the built-in file viewer and the built-in editor use automatic encoding detection, but you can specify one of the supported single-byte encodings as the default value. This parameter does not affect the automatic detection of multibyte encodings (UTF-8, UTF-16 and others). Special values are also available:
+-
+
Thumbnails – Here you can enable to save cache of thumbnails of images and set their size. The thumbnail cache directory can be found in the Configuration section. Double Commander uses PNG or JPEG (only for .bmp, .jpg and .jpeg) formats. The thumbnail name is the MD5 sum of the full name of the source file. The full name of the source file, its size and modification date will be added to the file.
The Remove thumbnails for no longer existing files button will help to remove obsolete thumbnails.
File comments (descript.ion) – Here you can set the default encoding for existing file comments (OEM, ANSI or UTF-8) and the encoding for new files (UTF-8 BOM, UTF-16 LE or UTF-16 BE).
@@ -1014,7 +1051,8 @@2. Configuration
{!TERMSTAYOPEN} and {!TERMANDCLOSE} have been added for unification and the ability to use the variables %t0 and %t1, {!SHELL} has been kept for backwards compatibility.
+"View" actions with the {!DC-VIEWER} macro will be taken into account for quick viewing, other macros and commands will be ignored.
+{!TERMSTAYOPEN} and {!TERMANDCLOSE} have been added for unification and the ability to use the variables %t0 and %t1, {!SHELL} has been kept for backwards compatibility.
As a command, you can use the internal commands of Double Commander. The parameters of the internal commands are specified one per line, so you can specify only one here. Also, using the internal command cm_ExecuteScript, you can run Lua scripts, in this case you can get the names of the selected files using cm_CopyFullNamesToClip or cm_SaveSelectionToFile.
Parameters – command parameters including variables:
-
@@ -1028,11 +1066,11 @@
2. Configuration
2.23.1. File associations > File associations extra
-
Offer to add selection to file association when not included already – When accessing file association, offer to add current selected file if not already included in a configured file type. This is a quick way to add an "Open with" action: Double Commander will prompt you to specify a type name and an executable file, everything else will be done automatically.
Extended context menu – allows to add some items to the "Actions" submenu:
-
-
from <Behaviours>
from <Behaviours>
True) or not (False). False by default.3. Options to change manually
-from <Colors>
-
| Tag | -File panel | -Description | -
|---|---|---|
| <ActiveColor> | -active | -background color | -
| <ActiveFontColor> | -font color | -|
| <InactiveColor> | -inactive | -background color | -
| <InactiveFontColor> | -font color | -
from <Colors><LogWindow>
from <Differ><Colors>
from <Differ><Colors><Binary>
from <Editor>
from <Editor>
True) or text from the search history (False). True by default.3. Options to change manually
from <FilesViews><ColumnsView>
from <FilesViews><ColumnsView>
True) or the number of files (False, by default).If
True, the status bar will also show the number of files when the cursor is on the ".." item. For links, target objects will additionally be displayed.3. Options to change manually
from <Miscellaneous>
-
| Value | -Description | -
|---|---|
| ANSI | -Default system ANSI encoding (depends on user locale). | -
| OEM | -Default system OEM (DOS) encoding (depends on user locale). | -
from <Miscellaneous>
from <Miscellaneous>
True value allows to use the file properties dialog window of the file manager, which is specified as the default program in the desktop environment settings (if it possible), otherwise, Double Commander will use its own properties window. False by default.3. Options to change manually
from <SyncDirs><FileMask>
from <SyncDirs><FileMask>
True with False@@ -534,27 +459,8 @@
3. Options to change manually
from <SyncDirs><Colors>
-
| Tag | -Description | -
|---|---|
| <Left> | -Files selected for copying or deleting on the left. | -
| <Right> | -Files selected for copying or deleting on the right. | -
| <Unknown> | -Files with the same names, but not identical. | -
from <SyncDirs>
Default value is
yyyy.mm.dd hh:nn:ss.3. Options to change manually
from <Viewer>
from <Viewer>
True) or disables (False) automatic copying of the selected text to the clipboard. True by default.3. Options to change manually
-from <Viewer>
from <Viewer>
ImageBackColor2 defines the color of the squares.- If not set, the viewer will automatically calculate the value: for a dark background, light squares will be used and vice versa. -
from <Viewer>
3. Options to change manually
from <Viewer>
from <Viewer>
3. Options to change manually
from <Viewer>
from <Viewer>
1. Copy/move dialog window
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; 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(*).
+ 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.
diff --git a/doc/en/faq.html b/doc/en/faq.html
index 90dfd648..1100ce3f 100644
--- a/doc/en/faq.html
+++ b/doc/en/faq.html
@@ -30,7 +30,6 @@ - 1.3. Is it a Total Commander for Linux?
- 1.4. What is the difference between this program and my favorite file manager (Total Commander)?
- 1.5. How can I contact the developers of Double Commander? -
- 1.6. How to update the portable version without losing settings?
- 2. Issues related to GNU/Linux @@ -77,19 +76,17 @@
- 5.3. Viewer does not work with a few images, but works with most.
- 5.4. On some text files lines go beyond the window's edge.
- 5.5. Can you add column editing feature (like in Notepad++, UltraEdit etc)? -
- 5.6. Is it possible to add SVG support in the viewer? -
- 5.7. How can I use regular expressions to search in UTF-8? -
- 5.8. How to change the syntax highlighting scheme in the internal editor or add new ones? +
- 5.6. How can I use regular expressions to search in UTF-8? +
- 5.7. How to change the syntax highlighting scheme in the internal editor or add new ones?
- 6. Issues related to the file panels
-
- 6.1. I didn't find a suitable date format for file panels in the list! How to add my own? -
- 6.2. Is it possible to add SVG thumbnails support in thumbnails view? -
- 6.3. I want to see the filenames in the "Name" column with extensions, can I do it? -
- 6.4. Is it possible to sort folders by clicking on column header ("Date", "Size" and so on)? -
- 6.5. How to see the target objects of symbolic links? +
- 6.2. I want to see the filenames in the "Name" column with extensions, can I do it? +
- 6.3. Is it possible to sort folders by clicking on column header ("Date", "Size" and so on)? +
- 6.4. How to see the target objects of symbolic links?
- 7. Plugins @@ -115,7 +112,7 @@
- multiarc.ini – see external archivers; -
- pixmaps.txt – see Configuration > Options... > Icons > Only standard icons. -
Linux: install package librsvg.
- Windows: needs libcairo-2.dll, librsvg-2-2.dll and libgobject-2.0-0.dll (+ all dependencies), for example, you can take DLLs from GIMP. You should copy this DLLs to Double Commander folder or in PATH.
- Linux: needs libpcre2-8.so.0. For example, package libpcre2-8-0 in Debian/Ubuntu or pcre2 in Arch Linux.
Windows: needs libpcre2-8.dll (by default, the Double Commander distribution contains this DLL).
- macOS(*): needs libpcre2-8.dylib.
+ macOS: needs libpcre2-8.dylib.
Opened tabs – only directories of opened tabs will be used (tabs of active and inactive panels).
Selected directories and files – if enabled, the search will be conducted only among selected files and folders in the active panel. If there are selected files/folders in the file panel, this option will be enabled automatically.
Follow symlinks – if a symbolic link to a directory is found, the target directory will be read and used, otherwise this symbolic link will be considered a regular file.
- Exclude subdirectories – a list of directories to be excluded from the search, here we can specify folder names and relative or absolute(Beta version) paths.
+ Exclude subdirectories – a list of directories to be excluded from the search, here we can specify folder names and relative or absolute paths.
Search subdirectories can have:
current dir only,
@@ -96,11 +96,11 @@ ANSI – default system ANSI encoding (depends on the system locale).
OEM – default system OEM (DOS) encoding (depends on the system locale).
2. Tab "Standard"
The Encoding button (
+
) allows to specify more than one encoding.(Beta version)The Encoding button (
) allows to specify more than one encoding.The Start button starts search, Cancel stops search and Close closes the Find files window.
New search – clears the old results and allows to start a new search (also with new conditions).
Last search – loads parameters from the previous search (in the current session, before closing Double Commander).
-If history saving is enabled, then we can use Shift+Del to remove unnecessary entries from the history of input fields.
+By default, Double Commander saves the history of the input fields, to delete unnecessary entries from the history, we can use Shift+Del, and we can also disable saving history in the Configuration settings section.
diff --git a/doc/en/help.html b/doc/en/help.html index d5547eae..1fbfed00 100644 --- a/doc/en/help.html +++ b/doc/en/help.html @@ -93,14 +93,13 @@1.2. Usage
And you can build Double Commander yourself.
Content
Content
1. Common questions
Q: Is it a Total Commander for Linux?
-A: 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.
+A: 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.
Q: What is the difference between this program and my favorite file manager (Total Commander)?
@@ -127,22 +124,13 @@1. Common questions
A: The project's official forum or GitHub.
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 #117.
- -
Q: How to update the portable version without losing settings?
-A: Upgrading is done by simply unpacking and replacing files, but you should pay attention to the following files:
--
-
If you did not change these settings, then just agree with the replacement of files. Otherwise, compare with yours and copy the changes.
2. Issues related to GNU/Linux
Q: Which version do I download?
-A: If you have KDE or LXQt – download a Qt-build; in other cases (Cinnamon, GNOME, LXDE, MATE or Xfce) a build for GTK toolkit. But this is not strict rule.
+A: If you have KDE, LXQt or Fly – download a Qt-build; in other cases (Cinnamon, GNOME, LXDE, MATE or Xfce) a build for GTK toolkit. But this is not strict rule.
Q: Where is the project repository?
@@ -340,35 +328,26 @@5. Issues related to the built-in viewer (F3) and editor (F4
Q: On some text files lines go beyond the window's edge.
- A: Use "Show as Wrap text" option in the viewer (in the "View" menu). Internal editor does not support wrap lines.
+ A: Enable "Wrap text" option in the viewer (in the "View" menu). Internal editor does not support wrap lines.
Q: Can you add column editing feature (like in Notepad++, UltraEdit etc)?
A: Internal editor supports column and line selection modes and multi-carets, see keyboard shortcuts here.
- Q: Is it possible to add SVG support in the viewer?
- A: Supported via librsvg:
-
-
-
-
Q: How can I use regular expressions to search in UTF-8?
A: 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):
Q: How to change the syntax highlighting scheme in the internal editor or add new ones?
A: DC uses two components:
1. SynEdit 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 > Options... > Tools > Editor > Highlighters. Do not forget to save customizations for each file type.
- All settings are saved in the highlighters.xml file.
+ But you can easily change the colors used and the file extension lists: go to "Configuration" in the main menu > Options... > Tools > Editor > Highlighters. Do not forget to save customizations for each file type.
2. SynUniHighlighter for custom syntax highlighting schemes (.hgl) and you can try to find or create this files yourself (see below).
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 <General> tag (inside <Info>):
1) Old format: <General> has tags
@@ -381,7 +360,7 @@
5. Issues related to the built-in viewer (F3) and editor (F4
How to create or edit:
Use UniHighlighter Editor or HglEditor (download). Both programs were written for Windows, but you can use Wine. HglEditor will save HGL-file in the new format.
Two packs of various highlighters are also available.
- In the Tools > Editor > Highlighters section, you can change the text and background colors and font style.(Beta version)
+ In the Tools > Editor > Highlighters section, you can change the text and background colors and font style.
How to add:
1) Portable version
Copy (or move) your HGL-file(s) to the "highlighters" folder near doublecmd.exe and restart DC.
@@ -412,10 +391,6 @@ 6. Issues related to the file panels
A: Date and time format is easy configurable: go to Configurations > Options > Files views > Formatting > Date and time format and use this table.
- Q: Is it possible to add SVG thumbnails support in thumbnails view?
- A: It's already supported, see Is it possible to add SVG support in the viewer?
-
-
Q: I want to see the filenames in the "Name" column with extensions, can I do it?
A: Yes, it's possible. Go to "Configuration" in the main menu > Options... > Files views > Columns > Custom columns,
now create a new column set or change existing default set: by default, DC uses GETFILENAMENOEXT field for name, use GETFILENAME instead.
@@ -448,11 +423,11 @@ 7. Plugins
- A: This server requires session reuse support and the FTP plugin supports it, but the OpenSSL libraries are needed: put libeay32.dll and ssleay32.dll near doublecmd.exe or in the PATH.
+ A: This server requires session reuse support and the FTP plugin supports it, but requires a library that supports SSL and TLS protocols (see the description of the plugin). Put the libraries near doublecmd.exe or in the PATH (Windows) or install the appropriate package (Linux and other Unix-like systems).
- A: OpenSSL libraries required: put libeay32.dll and ssleay32.dll near doublecmd.exe or in the PATH.
+ A: Requires a library that supports SSL and TLS protocols (see the description of the plugin). Put the libraries near doublecmd.exe or in the PATH (Windows) or install the appropriate package (Linux and other Unix-like systems).
- All settings are saved in the highlighters.xml file.
<General> tag (inside <Info>):<General> has tags@@ -381,7 +360,7 @@
How to create or edit:
Use UniHighlighter Editor or HglEditor (download). Both programs were written for Windows, but you can use Wine. HglEditor will save HGL-file in the new format.
Two packs of various highlighters are also available.
- In the Tools > Editor > Highlighters section, you can change the text and background colors and font style.(Beta version)
How to add:
1) Portable version
Copy (or move) your HGL-file(s) to the "highlighters" folder near doublecmd.exe and restart DC.
6. Issues related to the file panels
A: Date and time format is easy configurable: go to Configurations > Options > Files views > Formatting > Date and time format and use this table.
-
Q: Is it possible to add SVG thumbnails support in thumbnails view?
-A: It's already supported, see Is it possible to add SVG support in the viewer?
--
Q: I want to see the filenames in the "Name" column with extensions, can I do it?
A: Yes, it's possible. Go to "Configuration" in the main menu > Options... > Files views > Columns > Custom columns,
now create a new column set or change existing default set: by default, DC uses GETFILENAMENOEXT field for name, use GETFILENAME instead.
7. Plugins
-
A: This server requires session reuse support and the FTP plugin supports it, but the OpenSSL libraries are needed: put libeay32.dll and ssleay32.dll near doublecmd.exe or in the PATH.
+A: This server requires session reuse support and the FTP plugin supports it, but requires a library that supports SSL and TLS protocols (see the description of the plugin). Put the libraries near doublecmd.exe or in the PATH (Windows) or install the appropriate package (Linux and other Unix-like systems).
-
A: OpenSSL libraries required: put libeay32.dll and ssleay32.dll near doublecmd.exe or in the PATH.
+A: Requires a library that supports SSL and TLS protocols (see the description of the plugin). Put the libraries near doublecmd.exe or in the PATH (Windows) or install the appropriate package (Linux and other Unix-like systems).
2. Tab "Standard"
Version archive is also available.
-First, you must choose which operating system (Windows, Linux, macOS(*)), processor architecture and then you may select the version to download.
+First, you must choose which operating system (Windows, Linux, macOS), processor architecture and then you may select the version to download.
For Windows there is an executable file .exe (Inno Setup) or .msi and an archive .zip (which is the so-called portable version).
-For Linux there are versions based on GTK toolkit and based on Qt. Also portable versions are available (compiled binaries packed with XZ, use doublecmd.sh to launch).
-Note: The features of the update of the portable version are described in the FAQ.
+For Linux there are versions based on GTK toolkit and based on Qt. Also available: portable versions (compiled binaries packed with XZ) and files in the AppImage format.
On the first launch Double Commander will automatically detect the system language, and set it for the interface. DC is translated into many languages. The language can be changed in the menu via Configuration > Options... > Language.
Double Commander determines and uses the current system theme. It looks like this (Ubuntu, three themes and two icon sets):
As can be seen from the figure, there are left file panel, a command line and a lower window that is a log viewer (it shows all the actions from the file manager). Double Commander also supports dark mode in Windows (Windows 10 1809 and newer).(Beta version)
+As can be seen from the figure, there are left file panel, a command line and a lower window that is a log viewer (it shows all the actions from the file manager). Double Commander also supports dark mode in Windows (Windows 10 1809 and newer).
Double Commander uses Total Commander plugin API, so under Windows you can use plugins from Total Commander (many of them are compatible with DC). See the description of the types of plugins in the Plugins settings section. DC is distributed with several pre-installed plugins, other plugins can be installed manually.
@@ -130,7 +129,7 @@2.1.1. "Files"
Create Directory (internal command cm_MakeDir) – creates a new subdirectory in the current directory. The file name (without extension) or directory name under the cursor will be offered, this is useful for creating multiple directories with similar names. You can also create several subdirectories in one operation, just separate the subdrectories with the directory separator (in Unix/Linux system it will be "/" and in Windows it will be "\").
If Extended syntax(Beta version) is enabled, the <[] template can be used to insert the current date/time: inside square brackets you can use date and time formatting characters and any characters allowed for filenames.
If Extended syntax is enabled, the <[] template can be used to insert the current date/time: inside square brackets you can use date and time formatting characters and any characters allowed for filenames.
Create Shortcut (Windows only) – Double Commander creates a shortcut (Microsoft Windows .lnk file) to the file under the cursor and places it in the folder opened in the opposite panel.
@@ -138,11 +137,11 @@2.1.1. "Files"
Show file properties... (internal command cm_FileProperties) will show the default "Properties" dialog (Windows) or Double Commander own dialog (Linux and other Unix-like systems) like this:
- 
- 
- 
+
+
+
which indicates the file or folder name, size, write and last access time, and also owner and group. On the "Attributes" tab you can change the access to the file (if you have the rights to do so). The "Plugins" tab is optional and is only available if you have a suitable content plugin (in this case it was DEB). Also see description of <SystemItemProperties>.
+which indicates the file or folder name, MIME type, size, write and last access time. For links, Double Commander will additionally show the link object (symbolic link) or their total number (hard link). On the "Attributes" tab you can change the access rights to the file and its owner (if you have the rights to do so). The "Plugins" tab is optional and is only available if you have a suitable content plugin (in this case it was DEB). Also see description of <SystemItemProperties>.
Using item Edit comment... (internal command cm_EditComment) you can create or change file comments, which stored in a file descript.ion. Supports UTF, ISO, KOI and ANSI encodings. In the Miscellaneous settings section you can set the default text encoding.
Comments only work with normal files on the local file system, but not on remote or virtual file systems (e.g. on FTP server, in archive, etc.). In order for Double Commander to take into account the contents of descript.ion when copying or moving files, make sure that Process comments with files/folders is enabled in the File operations settings section.
@@ -162,7 +161,7 @@2.1.1. "Files"
Binary mode – result is presented in binary form.
Keep scrolling – allows synchronized scrolling (vertical and horizontal).
Also see description of <Added>, <Deleted> and <Modified> parameters and Position of frame panel after the comparison.
The colors used can be changed in the Colors settings section (the Differ category). Also see Position of frame panel after the comparison.
The two files will be chosen as follows
If two files are selected in the active panel, they will be opened in the compare tool. The first selected file will be opened in the left panel of the comparison tool.
@@ -183,7 +182,7 @@ Computer(Beta version) – 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.
- Linux(Beta version) – list of all Linux distributions that you added to WSL and their root file systems (Windows 10 and newer).
+ Computer – 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.
+ Linux – list of all Linux distributions that you added to WSL and their root file systems (Windows 10 and newer).
Network – used to access shared network resources (Windows only).
Recycle Bin – used to access files deleted to trash.
Windows: Double Commander uses the capabilities of the operating system (as in Windows Explorer), WLX plugins with thumbnail creation support and supplements the list with image formats that are supported by the built-in viewer.
- macOS(*): Double Commander uses the capabilities of the operating system (Quick Look) and supplements the list with image formats that are supported by the built-in viewer. The program also supports the OpenDocument format (.odt, .ods, .odp, .odg) and will try to create thumbnails (if files contains "Thumbnails/thumbnail.png") before using the Quick Look API.
+ macOS: Double Commander uses the capabilities of the operating system (Quick Look) and supplements the list with image formats that are supported by the built-in viewer. The program also supports the OpenDocument format (.odt, .ods, .odp, .odg) and will try to create thumbnails (if files contains "Thumbnails/thumbnail.png") before using the Quick Look API.
-
Linux and other Unix-like systems: Double Commander creates thumbnails for the following formats:
-
@@ -499,7 +500,6 @@
Open – Open the file under the cursor in the default program (system file associations will be used).
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).
+ 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...-
+
macOS: will open a list of all installed applications.
+ Linux and other Unix-like systems: 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 – macOS only, an analogue of the "Services" system submenu.
+ Share... – macOS only, an analogue of the "Share" system submenu.
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.
Calling basic file operations: Move (F6), Copy (F5), Delete (F8), Rename (F2).
@@ -525,7 +531,7 @@ Refresh – the command to reread the contents of the directory in the panel.
The Sort by submenu – contains commands for switching the sorting method: by name, file extension, size, modification date or attributes. Also added the Reverse Order command which switches the sorting direction.
Paste – used to copy and move files using the clipboard.
- The New submenu – contains commands for creating a directory (F7) and a text file (Shift+F4). Also this submenu contains templates for new files, if the system directory with templates exists and is not empty (not available in macOS(*)).
+ The New submenu – contains commands for creating a directory (F7) and a text file (Shift+F4). Also this submenu contains templates for new files, if the system directory with templates exists and is not empty (not available in macOS).
Show file properties – Show the properties window of the current directory.
- 3.5. UTF-8 library -
- 3.6. Char library(Beta version) +
- 3.6. Char library
- 3.7. OS library @@ -71,7 +71,7 @@
2.8. File Panels
Double Commander supports the ability to drag and drop files using the mouse (that is, with the left mouse button pressed) to the windows of external applications (for example, a text or graphics editor or viewer), to the toolbar and copying/moving files between directories. If the action is possible, the "+" symbol will be displayed near the mouse cursor.
When dragging a file to an empty place on the toolbar, a button with an external command will be created, the passed file will be used as a command. Dragging a file to a button is only possible if it is a button with an external command: the command will launched and the file will be passed to it as a launch parameter.
For file copy or move (using the Ctrl or Shift key) operations, the following targets are possible: the opposite file panel, any folder in the active or inactive panel (the folder name will be highlighted with a frame), the directory of any open tab (just drop the files on the header of the desired tab). Use ".." to copy files to the parent directory. Double Commander can also copy files to an archive if adding files is supported.
-If more than one file is selected, press the modifier key after the start of dragging.
Dragging using the right mouse button will show the menu with the following actions: Copy, Move, Create link (hard link), Create symlink and Cancel. If several files are selected, Double Commander will offer to create a link only for the first file in the list.
You can create a symbolic link using Ctrl+Shift.
When you drag files to the window of another application, Double Commander uses the system implementation of drag & drop. Using the Alt key, you can call an alternative action (for example, when dragging a file into the Windows Explorer window, a shortcut will be created instead of copying the file).
@@ -511,9 +511,15 @@2.8. File Panels
2.8. File Panels
Context menu inside an open archive or a file system plugin (WFX) is always the same and does not depend on the operating system:
diff --git a/doc/en/images/imgDC/archiveimg1.png b/doc/en/images/imgDC/archiveimg1.png index ceee64ff..f1ad2fc6 100644 Binary files a/doc/en/images/imgDC/archiveimg1.png and b/doc/en/images/imgDC/archiveimg1.png differ diff --git a/doc/en/images/imgDC/archiveimg11.png b/doc/en/images/imgDC/archiveimg11.png index c4611e04..90127224 100644 Binary files a/doc/en/images/imgDC/archiveimg11.png and b/doc/en/images/imgDC/archiveimg11.png differ diff --git a/doc/en/images/imgDC/archiveimg15.png b/doc/en/images/imgDC/archiveimg15.png index aaffc6d3..3eade81c 100644 Binary files a/doc/en/images/imgDC/archiveimg15.png and b/doc/en/images/imgDC/archiveimg15.png differ diff --git a/doc/en/images/imgDC/archiveimg3.png b/doc/en/images/imgDC/archiveimg3.png index fe5b66ee..fda5f847 100644 Binary files a/doc/en/images/imgDC/archiveimg3.png and b/doc/en/images/imgDC/archiveimg3.png differ diff --git a/doc/en/images/imgDC/btemplate.png b/doc/en/images/imgDC/btemplate.png index a94a6969..2a71c198 100644 Binary files a/doc/en/images/imgDC/btemplate.png and b/doc/en/images/imgDC/btemplate.png differ diff --git a/doc/en/images/imgDC/dirhotconfigure.png b/doc/en/images/imgDC/dirhotconfigure.png index 6f10a7f6..69eec8e1 100644 Binary files a/doc/en/images/imgDC/dirhotconfigure.png and b/doc/en/images/imgDC/dirhotconfigure.png differ diff --git a/doc/en/images/imgDC/dirhotoverview.png b/doc/en/images/imgDC/dirhotoverview.png index eb0b0e68..aba24678 100644 Binary files a/doc/en/images/imgDC/dirhotoverview.png and b/doc/en/images/imgDC/dirhotoverview.png differ diff --git a/doc/en/images/imgDC/dirhotpersonalize.png b/doc/en/images/imgDC/dirhotpersonalize.png index 527cc823..df889a77 100644 Binary files a/doc/en/images/imgDC/dirhotpersonalize.png and b/doc/en/images/imgDC/dirhotpersonalize.png differ diff --git a/doc/en/images/imgDC/dirhotsettarget.png b/doc/en/images/imgDC/dirhotsettarget.png index 2c3738e8..d483e417 100644 Binary files a/doc/en/images/imgDC/dirhotsettarget.png and b/doc/en/images/imgDC/dirhotsettarget.png differ diff --git a/doc/en/images/imgDC/luaimg1.png b/doc/en/images/imgDC/luaimg1.png index eb5a60c2..668041e8 100644 Binary files a/doc/en/images/imgDC/luaimg1.png and b/doc/en/images/imgDC/luaimg1.png differ diff --git a/doc/en/images/imgDC/pic16.png b/doc/en/images/imgDC/pic16.png index 6e37394f..9e3b1ced 100644 Binary files a/doc/en/images/imgDC/pic16.png and b/doc/en/images/imgDC/pic16.png differ diff --git a/doc/en/images/imgDC/pic17.png b/doc/en/images/imgDC/pic17.png index 1a9981b0..c5adf16d 100644 Binary files a/doc/en/images/imgDC/pic17.png and b/doc/en/images/imgDC/pic17.png differ diff --git a/doc/en/images/imgDC/pic18.png b/doc/en/images/imgDC/pic18.png index 05d6e7fc..71458653 100644 Binary files a/doc/en/images/imgDC/pic18.png and b/doc/en/images/imgDC/pic18.png differ diff --git a/doc/en/images/imgDC/pic26.png b/doc/en/images/imgDC/pic26.png index 2e8c0384..fdc6ac44 100644 Binary files a/doc/en/images/imgDC/pic26.png and b/doc/en/images/imgDC/pic26.png differ diff --git a/doc/en/images/imgDC/pic30.png b/doc/en/images/imgDC/pic30.png index 3d978892..478d3693 100644 Binary files a/doc/en/images/imgDC/pic30.png and b/doc/en/images/imgDC/pic30.png differ diff --git a/doc/en/images/imgDC/pic31.png b/doc/en/images/imgDC/pic31.png index 6cc3783b..01ce89ca 100644 Binary files a/doc/en/images/imgDC/pic31.png and b/doc/en/images/imgDC/pic31.png differ diff --git a/doc/en/images/imgDC/pic41.png b/doc/en/images/imgDC/pic41.png index 68b59983..17abe7b2 100644 Binary files a/doc/en/images/imgDC/pic41.png and b/doc/en/images/imgDC/pic41.png differ diff --git a/doc/en/images/imgDC/pic46.png b/doc/en/images/imgDC/pic46.png index 1cba1d14..5cef3f16 100644 Binary files a/doc/en/images/imgDC/pic46.png and b/doc/en/images/imgDC/pic46.png differ diff --git a/doc/en/images/imgDC/pic50.png b/doc/en/images/imgDC/pic50.png index 15167c73..df022c6f 100644 Binary files a/doc/en/images/imgDC/pic50.png and b/doc/en/images/imgDC/pic50.png differ diff --git a/doc/en/images/imgDC/pic51.png b/doc/en/images/imgDC/pic51.png index 33f4cd00..a356ad88 100644 Binary files a/doc/en/images/imgDC/pic51.png and b/doc/en/images/imgDC/pic51.png differ diff --git a/doc/en/images/imgDC/pic59.png b/doc/en/images/imgDC/pic59.png new file mode 100644 index 00000000..3ee345f4 Binary files /dev/null and b/doc/en/images/imgDC/pic59.png differ diff --git a/doc/en/images/imgDC/pic6.png b/doc/en/images/imgDC/pic6.png index 575bbd5e..24115403 100644 Binary files a/doc/en/images/imgDC/pic6.png and b/doc/en/images/imgDC/pic6.png differ diff --git a/doc/en/images/imgDC/pic69.png b/doc/en/images/imgDC/pic69.png index 1db2c9ea..037ddb63 100644 Binary files a/doc/en/images/imgDC/pic69.png and b/doc/en/images/imgDC/pic69.png differ diff --git a/doc/en/images/imgDC/pic75.png b/doc/en/images/imgDC/pic75.png index ad14e3b7..20e5087c 100644 Binary files a/doc/en/images/imgDC/pic75.png and b/doc/en/images/imgDC/pic75.png differ diff --git a/doc/en/images/imgDC/pic79.png b/doc/en/images/imgDC/pic79.png index a7a95769..0adc0624 100644 Binary files a/doc/en/images/imgDC/pic79.png and b/doc/en/images/imgDC/pic79.png differ diff --git a/doc/en/images/imgDC/pic81.png b/doc/en/images/imgDC/pic81.png new file mode 100644 index 00000000..126cd8d8 Binary files /dev/null and b/doc/en/images/imgDC/pic81.png differ diff --git a/doc/en/images/imgDC/syncdirscomp.png b/doc/en/images/imgDC/syncdirscomp.png index ff567804..fd1bc26f 100644 Binary files a/doc/en/images/imgDC/syncdirscomp.png and b/doc/en/images/imgDC/syncdirscomp.png differ diff --git a/doc/en/images/imgDC/toolbarexternal.png b/doc/en/images/imgDC/toolbarexternal.png index 8645c9e1..074d1242 100644 Binary files a/doc/en/images/imgDC/toolbarexternal.png and b/doc/en/images/imgDC/toolbarexternal.png differ diff --git a/doc/en/images/imgDC/toolbarinternal1.png b/doc/en/images/imgDC/toolbarinternal1.png index 4ea601b8..f86aed62 100644 Binary files a/doc/en/images/imgDC/toolbarinternal1.png and b/doc/en/images/imgDC/toolbarinternal1.png differ diff --git a/doc/en/images/imgDC/toolbarinternal2.png b/doc/en/images/imgDC/toolbarinternal2.png index 9174996a..a9fb8ad3 100644 Binary files a/doc/en/images/imgDC/toolbarinternal2.png and b/doc/en/images/imgDC/toolbarinternal2.png differ diff --git a/doc/en/images/imgDC/viewer.png b/doc/en/images/imgDC/viewer.png index 764cfcaa..9bace7b5 100644 Binary files a/doc/en/images/imgDC/viewer.png and b/doc/en/images/imgDC/viewer.png differ diff --git a/doc/en/images/imgDC/viewerpreview.png b/doc/en/images/imgDC/viewerpreview.png index 8d9a9a43..e1c90468 100644 Binary files a/doc/en/images/imgDC/viewerpreview.png and b/doc/en/images/imgDC/viewerpreview.png differ diff --git a/doc/en/images/screenshot.png b/doc/en/images/screenshot.png index 804bd02b..3c216438 100644 Binary files a/doc/en/images/screenshot.png and b/doc/en/images/screenshot.png differ diff --git a/doc/en/lua.html b/doc/en/lua.html index 684f654a..241f1e78 100644 --- a/doc/en/lua.html +++ b/doc/en/lua.html @@ -59,7 +59,7 @@Content
1. Introduction
Detailed information about the Lua scripting programming language can be found on the Lua website.
Double Commander can execute Lua scripts via cm_ExecuteScript command.
Script parameters must be passed as is, without escaping (without quotes or "\"), for this we need to use the %"0 variable: for example,%"0%p0for the file under cursor instead of%p0or%"0%Dfor the current directory instead of%D. Otherwise, if Double Commander automatically adds quotes, they will be passed as part of the parameter and you will have to take them into account.
- To get a list of all selected files we can use variables (%LU,%FUor%RU) or internal commands (cm_SaveSelectionToFile, cm_SaveFileDetailsToFile(Beta version), cm_CopyFullNamesToClip or cm_CopyFileDetailsToClip). + To get a list of all selected files we can use variables (%LU,%FUor%RU) or internal commands (cm_SaveSelectionToFile, cm_SaveFileDetailsToFile, cm_CopyFullNamesToClip or cm_CopyFileDetailsToClip). We can use, for example,%p: in this case, Double Commander will pass the names of all selected files in one line, separating the names with a space.It is also possible to write content plugins using Lua script, examples can be found in the program folder (plugins/wdx/scripts). The Wiki has a page dedicated to writing plugins. @@ -106,7 +106,7 @@
1. Introduction
2. DLL required
In order to interpret Lua script file, we need to have a Lua DLL file, Double Commander supports versions 5.1 - 5.4.
-By default DC looks for a file with name lua5.1.dll (Windows), liblua5.1.so.0 (Unix or GNU/Linux) or liblua5.1.dylib (macOS(*)) in its directory and in the system directory. We can change the file name (and path) in the Lua library file to use parameter.
+By default DC looks for a file with name lua5.1.dll (Windows), liblua5.1.so.0 (Unix or GNU/Linux) or liblua5.1.dylib (macOS) in its directory and in the system directory. We can change the file name (and path) in the Lua library file to use parameter.
We can use DLL file from LuaJIT project. 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.
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.
@@ -438,6 +438,13 @@3.2. System library
sSeparator and iMaskOptions (see above) are optional parameters.
2.1.1. "Files"
In the Extract files matching file mask line, you can specify a mask, determining which files will be unpacked. The history of masks can be found in the drop-down list. The next line specifies the destination directory (where the archive will be unpacked). It can be changed manually or by clicking on the browse button at the far right.
-Unpack each archive to a separate subdir (name of the archive) – If checked, Double Commander will create a folder with the same name as the archive in the destination directory and extract the files into this folder. You can extract several archives at once with this option and each will be extracted into its own folder in the target directory. The indeterminate checkbox state (three-state) enables the smart extract(Beta version): if there are several objects in the root of the archive, then the contents of the archive will be unpacked into a folder with the name of the archive, but if there is one object, then the contents will be unpacked as is. By default it is unchecked and its state is not saved for the next call of the extract command.
+Unpack each archive to a separate subdir (name of the archive) – If checked, Double Commander will create a folder with the same name as the archive in the destination directory and extract the files into this folder. You can extract several archives at once with this option and each will be extracted into its own folder in the target directory. The indeterminate checkbox state (three-state) enables the smart extract: if there are several objects in the root of the archive, then the contents of the archive will be unpacked into a folder with the name of the archive, but if there is one object, then the contents will be unpacked as is. By default it is unchecked and its state is not saved for the next call of the extract command.
Unpack path names if stored with files – If checked, the directory structure in the archive will be kept. Otherwise, all files will be extracted without re-creating the directory structure.
Checkbox Overwrite existing files disables confirmation of overwriting existing files.
@@ -212,13 +211,15 @@2.1.1. "Files"
Save checksum file(s) to: – line specifies name and path to the calculated checksum.
Create separate checksum files for each file – if checksum calculates for multiple files, this option allows to create separate checksum files for each target file.
+File format – allows to specify the line ending type and directory separator instead of the commonly used values in Windows (CRLF and "\") and Unix-like systems (LF and "/").
Choose your preferred checksum and – select algorithm which will calculate checksums.
Item Verify Checksum... (internal command cm_CheckSumVerify) will start verification the list of checksums from the checksum file under the cursor. Also you can run this command by double mouse clicking on the checksum file (or using the Enter key).
Double Commander can check files one by one: select the file, run this command, now enter its checksum (or paste from the clipboard) and select the algorithm.
You can use checksum files, which generated by other programs, but first make sure Double Commander supports their algorithm and format.
-Item Wipe (internal command cm_Wipe) for secure deletion (shortcut Alt+Del by default): before deleting from the hard disk, the selected file will be renamed with a random name, and its contents will be overwritten with zeros, ones or random data. You can set number of wipe passes in Configuration > Options... > File operations. Directories and links will just be renamed before deleting.
+Item Wipe (internal command cm_Wipe) for secure deletion (shortcut Alt+Del by default): before deleting from the hard disk, the selected file will be renamed with a random name, and its contents will be overwritten three times (zeros, ones and random data). You can set number of wipe passes in Configuration > Options... > File operations. Directories and links will just be renamed before deleting.
+Note: Some features of solid-state drives (garbage collection, TRIM) significantly complicate the recovery of deleted files or make it impossible, therefore, using the cm_Wipe command on an SSD can be a pointless waste of device resource.
Item Delete (internal command cm_Delete) – will delete the selected files or the file under the cursor to trash (recycle bin) or permanently. By default, Double Commander moves files to trash, you can change this in Configuration > Options... > File operations. Deleting to trash can might not be available for all platforms.
To delete files inside archive (in this case the files will be deleted directly), you need to add a suitable WCX plugin or configure an external archiver, also the archive format must support the delete operation.
@@ -266,8 +267,8 @@2.1.3. "Commands"
Flat view (internal command cm_FlatView) will scan all the directories of panel to show all content in one single panel.
Open VFS List (internal command cm_OpenVirtualFileSystemList) will open a list of added file system plugins (WFX plugins) that use their own file systems or provide access to other file systems and devices (local or remote). As well as virtual folders:
-
-
2.4. Drives list
2.5. Tabs bar
Display tabs. Click on tabs with left mouse or you can use the keyboard to navigate tabs (Ctrl+Tab and Ctrl+Shift+Tab by default). To change the order of the tabs, use drag & drop or the cm_MoveTabLeft and cm_MoveTabRight commands(Beta version).
+Display tabs. Click on tabs with left mouse or you can use the keyboard to navigate tabs (Ctrl+Tab and Ctrl+Shift+Tab by default). To change the order of the tabs, use drag & drop or the cm_MoveTabLeft and cm_MoveTabRight commands.
You can protect tabs from closing or changing the directory, the available tab states are described in the "Tabs" subsection. Locked tabs are marked with an asterisk (if Show locked tabs with an asterisk * is enabled).
2.8. File Panels
The methods of creating thumbnails and the supported file formats depend on the family of the operating system.
sTempFileName = SysUtils.GetTempName()
+Will return a filename to use as a temporary filename (in the system directory for the temporary files), similar to the os.tmpname function, but the file will be created in a subdirectory that is automatically deleted when Double Commander is closed.
If the function could not create a unique name, it will return an empty string.
3.4. Dialogs library
sItem = Dialogs.InputListBox(sTitle, sMessage, aItems, sDefault)
+sItem, iItem = Dialogs.InputListBox(sTitle, sMessage, aItems, sDefault)
Displays a dialog box to allow the user to choose from a list of items.
Here is the description of each field:
-
@@ -728,6 +735,7 @@
- aItems : A Lua table, each element of the table must be a string.
- sDefault : The default selected item in the list.
- sItem : Returned the selected item as a string or
nilif the dialog is dismissed.
+ - iItem : Index of the selected item (counting from one, as is customary in Lua tables).
3.4. Dialogs library
3.5. UTF-8 library
LazUtf8.Next(String)
An iterator function that, each time it is called, returns the next character in the String and the position of the beginning of this character (in bytes).
@@ -1027,12 +1035,19 @@3.5. UTF-8 library
sEnc = LazUtf8.DetectEncoding(String)
+Returns the value of encoding of the transmitted text.
The list of supported encodings is similar to those used in the LazUtf8.ConvertEncoding function.
– unknown;
- 
- 
+ 
