<legalnotice>&FDLNotice;</legalnotice>
-<date>2019-02-17</date>
-<releaseinfo>Applications 19.04</releaseinfo>
+<date>2020-06-10</date>
+<releaseinfo>Applications 20.08</releaseinfo>
<abstract>
<para>
provides quick access to bookmarked locations and disks or other media.
</para>
<para>If desktop search and file indexing are enabled in the <guilabel>Desktop Search</guilabel>
-module in the &systemsettings; the panel provides <guilabel>Recently Saved</guilabel>
+module in the &systemsettings; the panel provides <guilabel>Recent</guilabel>
items and allows you to search for <guilabel>Documents</guilabel>, <guilabel>Images</guilabel>,
<guilabel>Audio Files</guilabel> and <guilabel>Video</guilabel>.
</para></listitem>
All the settings discussed below and other options concerning, ⪚ the
sorting of the files in the current folder, can also be modified in the
<guimenu>View</guimenu> menu and in the
-<link linkend="view-properties-dialog">View Properties dialog</link>. By
+<link linkend="view-properties-dialog">View Display Style dialog</link>. By
default, these settings are remembered for each folder separately. This
behavior can be changed in the
<link linkend="preferences-dialog-general"><quote>General</quote></link> section of the settings.
used to manage files and folders on a remote host that is accessible
via <acronym>SSH</acronym>. To do this you would type <userinput>fish://username@remotehost</userinput>
into the location bar. Similar remote file management can be done on
-remote hosts accessible via the &FTP;, NFS, SFTP, SMB (CIFS) or webdav protocols.</para>
+remote hosts accessible via the &FTP;, &NFS;, SFTP, &SMB; (&CIFS;) or webdav protocols.</para>
-<para>It is also possible to use the kioslaves drop down list to access
+<para>It is also possible to use the kioslaves drop down box to access
&systemsettings;, fonts, trash, other programs and devices attached to your computer.
-See the drop down list for the full list of capabilities available from kioslaves on your system.
+See the drop down box for the full list of capabilities available from kioslaves on your system.
</para>
<screenshot>
<screeninfo>Screenshot of the list of kioslaves</screeninfo>
<para>
&dolphin; allows a number of panels to be placed next to the view. These can
-be enabled in <menuchoice><guimenu>View</guimenu><guisubmenu>Panels</guisubmenu></menuchoice>.
+be enabled in <menuchoice><guimenu>View</guimenu><guisubmenu>Show Panels</guisubmenu></menuchoice>.
By unlocking the panels and clicking and dragging a panel title, the panel can be moved
to a different position, even outside the window.
</para>
<title>Places</title>
<!--FIXME difference between places panel in dolphin + kde filedialog + konqueror:
context menu Icon Size? No different entries ?-->
-<!--Four groups: Places = Folders, Devices, with Baloo Recently Saved and Search For -->
+<!--Four groups: Places = Folders, Devices, Recent and with Baloo Search For -->
<para>
The <guilabel>Places</guilabel> panel is located at the left of the window by
default. The <guilabel>Places</guilabel> panel shows any locations you have
<listitem><para>
Settings which determine how the contents of a folder are displayed in &dolphin;.
-These settings are called <link linkend="view-properties">View Properties</link>
+These settings are called <link linkend="view-properties">View Display Styles</link>
and can be controlled with toolbar buttons, via the <guimenu>View</guimenu> menu,
-and with the <link linkend="view-properties-dialog">View Properties Dialog</link>.
-In the default configuration, the view properties are remembered for each folder,
-but &dolphin; can also be configured to use common view properties for all folders
+and with the <link linkend="view-properties-dialog">View Display Style dialog</link>.
+In the default configuration, all folders use the same display style,
+but &dolphin; can also be configured to remember each folder's display style separately
in the <link linkend="preferences-dialog-general-behavior"><quote>General</quote>
section of the settings</link>.
</para></listitem>
<itemizedlist>
<listitem><para>
-In the <guilabel>View</guilabel> section, you can configure whether the
-<link linkend="view-properties"> view properties</link> are stored for each
-folder or if common view properties are to be used for all folders.
+In the <guilabel>View</guilabel> section, you can configure whether the same
+<link linkend="view-properties">view display style</link> is shared among all folders
+or folders remember their own individual view display styles.
</para></listitem>
<listitem><para>
<para>
In this tab, you can configure for which file types previews are shown.
-Moreover, the maximum size of remote files for which previews are generated can be chosen.
+Moreover, the maximum size of local and remote files for which previews are generated can be chosen.
</para>
<para>
If previews are enabled for folders, previews of some files in the folder will
<title>Confirmations Tab</title>
<para>
In the ask for confirmation section, you can enable warning dialogs that
-are shown before potentially harmful actions .
+are shown before potentially harmful actions.
+</para>
+<para>
+It is also possible to choose the default action <guilabel>When opening an executable file</guilabel>. There are three options, namely <guimenuitem>Always ask</guimenuitem>, <guimenuitem>Open in application</guimenuitem>, and <guimenuitem>Run script</guimenuitem>.
</para>
<warning><para>The confirmation settings for <guilabel>Moving files or folders to trash</guilabel> and
<guilabel>Deleting files or folders</guilabel> affect file operations in &dolphin;, &konqueror;,
-<application>Gwenview</application> and all &kde; applications using the default &kde; file dialog,
+&gwenview; and all &kde; applications using the default &kde; file dialog,
whereas <guilabel>Closing Dolphin windows
with multiple tabs</guilabel> is a &dolphin; specific setting.</para></warning>
</sect3>
<itemizedlist>
<listitem><para>
-The <guilabel>Start in</guilabel> folder is the folder which is opened on startup. The
-location of the folder can be entered directly or chosen in a dialog which can
+The <guilabel>Show on startup</guilabel> option allows choosing the folder which is opened on startup.
+</para>
+<para>
+ If the <guimenuitem>Folders, tabs, and window state from last time</guimenuitem> item is selected then
+</para>
+<itemizedlist>
+ <listitem>
+ <para>When launched from the &GUI; or CLI without any &URL;s, &dolphin; restores session</para>
+ </listitem>
+ <listitem>
+ <para>When rebooting with &dolphin; open, it restores session normally after the system comes back</para>
+ </listitem>
+ <listitem>
+ <para>When launched with &URL;s, &dolphin; window is opened showing those &URL;s instead of restoring session</para>
+ </listitem>
+ <listitem>
+ <para>When &dolphin; is already running and a new window is opened, that new window shows a single tab with the same &URL; as was visible in the previously-open &dolphin; instance</para>
+ </listitem>
+</itemizedlist>
+<para>
+The location of the folder can also be entered directly or chosen in a dialog which can
be opened by clicking the button showing a <quote>folder</quote> icon. Moreover,
the current location or the default location (which is the user's home folder)
can be used as the startup folder by clicking the corresponding button.
</para></listitem>
<listitem><para>
-<guilabel>Split view mode</guilabel> controls if the
+<guilabel>Begin in split view mode</guilabel> controls if the
<link linkend="dolphin-view">&dolphin; view</link> is split on startup
-or not.
+or not for new windows.
+</para></listitem>
+
+<listitem><para>
+<guilabel>Show filter bar</guilabel> controls if the filter bar is shown on
+startup or not. See the <link linkend="filter-files">section on the filter bar</link>
+for details.
</para></listitem>
<listitem><para>
-<guilabel>Editable location bar</guilabel> controls if the location bar is in
+<guilabel>Make location bar editable</guilabel> controls if the location bar is in
editable mode on startup. The bread crumb mode of the location bar is used
otherwise. See the <link linkend="location-bar">section about the location bar</link>
for details about the two modes.
</para></listitem>
+<listitem><para>
+<guilabel>Open new folders in tabs</guilabel> controls whether &dolphin; should open a new folder in a new tab of the current instance when called externally. If not enabled, the new folders will be opened in new instances of &dolphin;. By default this option is enabled.
+</para></listitem>
+
<listitem><para>
If <guilabel>Show full path inside location bar</guilabel> is enabled, the full
path of the current location is shown in the bread crumb mode of the location bar.
one of the places in the <guilabel>Places</guilabel> panel.
</para></listitem>
-<listitem><para>
-<guilabel>Show filter bar</guilabel> controls if the filter bar is shown on
-startup or not. See the <link linkend="filter-files">section on the filter bar</link>
-for details.
-</para></listitem>
-
<listitem><para>
<guilabel>Show full path in title bar</guilabel> makes it easy to distinguish
between files or folders with the same name in different folders.
</para></listitem>
+
</itemizedlist>
</para>
<guilabel>Expandable folders</guilabel> determines whether any folders that have subfolders
are displayed in a tree view, where the sub items can be expanded by &LMB; clicking the
<guiicon>></guiicon> icon and collapsed by clicking the <guiicon>v</guiicon> icon.
-</para></listitem>
+</para>
+<para>
+<guilabel>Folder size displays</guilabel> allows defining the property to use then sorting folders by their size. It is possible to sort folders by <guilabel>Number of items</guilabel> or <guilabel>Size of contents</guilabel> and choose a limit to the recursive level (can be useful to constrain unneeded iterations in the deep folder structures or on the slow file systems).
+</para>
+</listitem>
</itemizedlist>
</para>
</sect3>
</sect1>
<!-- begin copy to konqueror filemanager.docbook -->
<sect1 id="view-properties">
-<title>Folder View Properties</title>
+<title>Folder View Display Style</title>
<para>
The following settings control how the contents of a folder are displayed in the
</itemizedlist>
<para>
-The view properties can be configured in the
+The view display style can be configured in the
<menuchoice><guimenu>View</guimenu></menuchoice> menu, some (such as the view
mode) can also be changed using toolbar buttons.
</para>
<sect2 id="view-properties-dialog">
-<title>The View Properties Dialog</title>
+<title>The View Display Style dialog</title>
<para>
<screenshot>
-<screeninfo>Screenshot of the View Properties dialog</screeninfo>
+<screeninfo>Screenshot of the View Display Style dialog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="viewproperties-dialog.png" format="PNG"/>
</imageobject>
<textobject>
-<phrase>The View Properties dialog.</phrase>
+<phrase>The View Display Style dialog.</phrase>
</textobject>
-<caption><para>The View Properties Dialog.</para></caption>
+<caption><para>The View Display Style Dialog.</para></caption>
</mediaobject>
</screenshot>
-The <guilabel>View Properties</guilabel> dialog can be used to quickly modify
-several view properties at once. This is done for the current folder, for the
+The <guilabel>View Display Style</guilabel> dialog can be used to quickly modify
+the view display styles for many folders at once. This is done for the current folder, for the
current folder including all subfolders, or even for all folders, depending on
the choice made in the <guilabel>Apply to</guilabel> section.
</para>
</para></listitem>
</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Duplicate Here</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Creates duplicates of selected items appending <replaceable> copy</replaceable> to the end of their names.</action></para></listitem>
+</varlistentry>
+
<varlistentry>
<term><menuchoice>
<shortcut>
</action></para></listitem>
</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>F5</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Copy to inactive split view</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Copies the currently selected item(s) from the active split view to the inactive split view.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>F6</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Move to inactive split view</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Moves the currently selected item(s) from the active split view to the inactive split view.
+Is disabled if the current user does not have write permission on the selected item(s).</action></para></listitem>
+</varlistentry>
+
<varlistentry>
<term><menuchoice>
<shortcut>
<listitem><para><action>Decreases the size of icons in the view.</action></para></listitem>
</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>0</keycap></keycombo>
+</shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Zoom Reset</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Resets the size of icons in the view to default.</action></para></listitem>
+</varlistentry>
+
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
-<guisubmenu>Additional Information</guisubmenu>
+<guisubmenu>Show Additional Information</guisubmenu>
</menuchoice></term>
<listitem><para><action>Displays additional information</action>
described in <link linkend="dolphin-view-information">Information in the View</link>.
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
-<guimenuitem>Preview</guimenuitem>
+<guimenuitem>Show Previews</guimenuitem>
</menuchoice></term>
<listitem><para><action>Displays a symbolic preview of the file contents </action> in the different
view modes.</para></listitem>
<keycombo action="simul">&Alt;<keycap>.</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu>
-<guimenuitem>Hidden Files</guimenuitem>
+<guimenuitem>Show Hidden Files</guimenuitem>
</menuchoice></term>
<listitem><para><action>Shows all the hidden files and sub-folders within the current
folder.</action>There is an alternate shortcut <keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
-<guisubmenu>Panels</guisubmenu>
+<guisubmenu>Show Panels</guisubmenu>
</menuchoice></term>
<listitem><para><action>Enables and disables</action> the different <link linkend="panels">panels</link>:
<guimenuitem>Places</guimenuitem> (<keycap>F9</keycap>), <guimenuitem>Information</guimenuitem>
<varlistentry>
<term><menuchoice>
<guimenu>View</guimenu>
-<guimenuitem>Adjust View Properties...</guimenuitem>
+<guimenuitem>Adjust View Display Style...</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Opens the <link linkend="view-properties-dialog">View Properties
+<listitem><para><action>Opens the <link linkend="view-properties-dialog">View Display Style
Dialog</link>.</action></para></listitem>
</varlistentry>
</variablelist>
<listitem><para><action>Opens &konsole; within the current folder.</action></para></listitem>
</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo>
+</shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>Open Preferred Search Tool</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens preferred search tool in the current folder.</action></para></listitem>
+</varlistentry>
+
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu>
<title>The Settings and Help Menu</title>
<para>
&dolphin; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
-menu items, for more information read the sections about the <ulink url="help:/fundamentals/ui.html#menus-settings"
->Settings Menu</ulink> and <ulink url="help:/fundamentals/ui.html#menus-help">Help Menu</ulink>
+menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings"
+>Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
of the &kde; Fundamentals.
</para>
</sect2>
<para>
The official channel for submitting bug reports is via the &kde; bug tracking
system. The &kde; bug tracker can be found at
-<ulink url="http://bugs.kde.org">http://bugs.kde.org</ulink>.
+<ulink url="https://bugs.kde.org">https://bugs.kde.org</ulink>.
</para>
</answer>
</qandaentry>
<para>
The official channel for submitting feature requests is via the &kde; bug
tracking system. The &kde; bug tracker can be found at
-<ulink url="http://bugs.kde.org">http://bugs.kde.org</ulink>.
+<ulink url="https://bugs.kde.org">https://bugs.kde.org</ulink>.
</para>
</answer>
projects / dolphin.git / blobdiff