<legalnotice>&FDLNotice;</legalnotice>
-<date>2016-06-01</date>
-<releaseinfo>Applications 16.04</releaseinfo>
+<date>2019-09-30</date>
+<releaseinfo>Applications 19.12</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>
<listitem><para>
A file or folder can be opened by clicking it with the &LMB; (or
double-clicking, if <guilabel>Double-click to open files and folders</guilabel>
-is enabled in the <link linkend="preferences-dialog-navigation"><quote>Navigation</quote>
-section of the settings</link>).
+is enabled in the &systemsettings; in the <menuchoice><guimenu>Input Devices</guimenu>
+<guimenuitem>Mouse</guimenuitem></menuchoice> module.
</para></listitem>
<listitem><para>
</mediaobject>
</screenshot>
+<para>If you click with the &MMB; the item in the history is opened in a new tab
+thus keeping the current tab with its content.
+</para>
</sect2>
<sect2 id="dolphin-view-appearance">
in a tree-like fashion if <link linkend="preferences-dialog-viewmodes-details">
<guilabel>Expandable folders</guilabel></link> are enabled:
Each subfolder of the current folder can be
-<quote>expanded</quote> or <quote>collapsed</quote> by clicking on the <guiicon>+</guiicon>
-or <guiicon>-</guiicon> icon next to it.</para></listitem>
+<quote>expanded</quote> or <quote>collapsed</quote> by clicking on the <guiicon>></guiicon>
+or <guiicon>v</guiicon> icon next to it.</para></listitem>
</itemizedlist>
</para>
<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
features a large preview of the selected item and allows you to assign a rating,
tags, and comments to it.
</para>
-
+<!--FIXME panel context menu-->
</sect2>
<sect2 id="folders-panel">
The <guilabel>Folders</guilabel> panel shows a tree view structure of the file
system. It only shows folders. Clicking a folder with the &LMB; opens this folder
in the &dolphin; view.
-
</para>
-
+<para>Use <guilabel>Limit to Home Directory</guilabel> to hide all folders from
+the tree view except your <guilabel>Home</guilabel>.
+</para>
</sect2>
<sect2 id="terminal-panel">
<para>
&dolphin; is capable of searching for files and for content in files. If <keycombo action="simul">
&Ctrl;<keycap>F</keycap></keycombo> is pressed or <menuchoice> <guimenu>Edit</guimenu>
-<guimenuitem>Find...</guimenuitem> </menuchoice> is used, the <guilabel>Find</guilabel>
+<guimenuitem>Search...</guimenuitem> </menuchoice> is used, the <guilabel>Search</guilabel>
bar will open already set up to search for files within the current folder and any sub-folders.
Start to type into the find input box and the search starts immediately.
<screenshot>
<para>The option from <guilabel>Everywhere</guilabel> with activated Baloo
services searches in all indexed folders, without Baloo this option
starts the search from the user's <replaceable>Home</replaceable> folder.</para>
-
<screenshot>
<screeninfo>Search with More Options</screeninfo>
<mediaobject>
</screenshot>
<para>
-Use the <guilabel>More Options</guilabel> button to extend the <guilabel>Find</guilabel>
+Use the <guilabel>More Options</guilabel> button to extend the <guilabel>Search</guilabel>
bar. This provides a very comfortable way for
the user to shrink the number of search results.</para>
<para>To start a search select one or more file types (<guilabel>Documents</guilabel>,
together with the <guilabel>Filter</guilabel> bar to find files using Baloo or limit
the search to files matching the filter expression.</para>
+<para>Use the Save icon to save a search to the <guilabel>Search For</guilabel>
+section in the <guilabel>Places</guilabel> panel to quickly access it again in the future.
+</para>
+<!--FIXME 16.12
+https://git.reviewboard.kde.org/r/123883/
+Add prototype of a "More search tools..." button
+-->
+
</sect2>
<sect2 id="mounting-storage-media">
</para>
</sect2>
-
+<!-- FIXME https://phabricator.kde.org/D10698-->
<sect2 id="batch-rename">
<title>Renaming A Batch Of Files</title>
<para>
will have the file name specified, including a number, ⪚, Image1.jpg,
Image2.jpg, Image3.jpg. This can be useful, ⪚, for pictures taken with a digital camera.
</para>
-
+<!--double click-->
<para>
If you wish to rename a batch of files, first select the files to be renamed.
This can be done by pressing the &LMB; and drawing a rectangle around the files
tab on the <guilabel>General</guilabel> page are shared with &konqueror; in filemanager mode.
</para>
+<sect2 id="preferences-dialog-general">
+<title>General</title>
+
+<para>
+This group contains settings which control the general behavior of &dolphin;.
+The group is divided further into four subgroups which can be accessed using the
+tab bar at the top.
+
+<screenshot>
+<screeninfo>Screenshot of the General settings in &dolphin;'s preferences dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="preferences-general-behavior.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>General Settings.</phrase>
+</textobject>
+<caption><para>General Settings in &dolphin;'s Preferences Dialog.</para></caption>
+</mediaobject>
+</screenshot>
+
+</para>
+
+<sect3 id="preferences-dialog-general-behavior">
+<title>Behavior Tab</title>
+
+<para>
+
+<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.
+</para></listitem>
+
+<listitem><para>
+<guilabel>Sorting Mode</guilabel> controls how items are sorted in
+the view. If <guilabel>Natural sorting</guilabel> is enabled, the sort order of three example files
+will be
+<orderedlist>
+<listitem><para>File1,</para></listitem>
+<listitem><para>File2,</para></listitem>
+<listitem><para>File10.</para></listitem>
+</orderedlist>
+If this option is disabled, the normal alphabetical sorting case sensitive or case insensitive
+will be used, which leads to the sort order
+<orderedlist>
+<listitem><para>File1,</para></listitem>
+<listitem><para>File10,</para></listitem>
+<listitem><para>File2.</para></listitem>
+</orderedlist>
+</para></listitem>
+
+<listitem><para>
+When hovering over a file or folder with the mouse, a small window with relevant
+information is shown if <guilabel>Show tooltips</guilabel> is enabled.
+</para></listitem>
+
+<listitem><para>
+<guilabel>Show selection marker</guilabel> shows a small <guibutton>+</guibutton>
+or <guibutton>-</guibutton> button above an item's icon if the item is hovered over
+with the mouse. These can be used to select or deselect the item.
+</para></listitem>
+
+<listitem><para>
+Enable <guilabel>Rename inline</guilabel> to use this mode if only one item is currently selected.
+If this option is disabled or several items are selected, a dialog will be displayed for renaming.
+</para></listitem>
+
+<listitem><para>Enabling <guilabel>Switch between split panes with tab key</guilabel>
+allows to switch split views with the 	 key.
+</para></listitem>
+
+<listitem><para>Disable <guilabel>Turning off split view closes active pane</guilabel>
+to close the inactive pane when you are turning off the split view mode, ⪚ pressing <keycap>F3</keycap>.
+</para></listitem>
+
+</itemizedlist>
+
+</para>
+
+</sect3>
+
+<sect3 id="preferences-dialog-general-previews">
+<title>Previews Tab</title>
+
+<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.
+</para>
+<para>
+If previews are enabled for folders, previews of some files in the folder will
+be shown inside a folder's icon.
+</para>
+</sect3>
+
+<sect3 id="preferences-dialog-general-confirmations">
+<title>Confirmations Tab</title>
+<para>
+In the ask for confirmation section, you can enable warning dialogs that
+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,
+whereas <guilabel>Closing Dolphin windows
+with multiple tabs</guilabel> is a &dolphin; specific setting.</para></warning>
+</sect3>
+
+<sect3 id="preferences-dialog-general-statusbar">
+<title>Status Bar Tab</title>
+
+<para>
+In this tab, some additional items can be enabled for the status bar, provided
+the status bar is wide enough:
+
+<itemizedlist>
+
+<listitem><para>
+A <guilabel>zoom slider</guilabel> which can be used to change the icon size quickly.
+</para></listitem>
+
+<listitem><para>
+A bar that shows how much space is free on the current drive.
+</para></listitem>
+
+</itemizedlist>
+
+</para>
+
+</sect3>
+
+</sect2>
+
<sect2 id="preferences-dialog-startup">
<title>Startup</title>
<itemizedlist>
<listitem><para>
-The <guilabel>Home Folder</guilabel> is the folder which is opened on startup. The
+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
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 Home Folder by clicking the corresponding button.
+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>Split view mode</guilabel> controls if the
<link linkend="dolphin-view">&dolphin; view</link> is split on startup
or not.
</para></listitem>
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>
+
+<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>
</itemizedlist>
</para>
</sect2>
-<sect2 id="preferences-dialog-general">
-<title>General</title>
-
-<para>
-This group contains settings which control the general behavior of &dolphin;.
-The group is divided further into four subgroups which can be accessed using the
-tab bar at the top.
-
-<screenshot>
-<screeninfo>Screenshot of the General settings in &dolphin;'s preferences dialog</screeninfo>
-<mediaobject>
-<imageobject>
-<imagedata fileref="preferences-general-behavior.png" format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>General Settings.</phrase>
-</textobject>
-<caption><para>General Settings in &dolphin;'s Preferences Dialog.</para></caption>
-</mediaobject>
-</screenshot>
-
-</para>
-
-<sect3 id="preferences-dialog-general-behavior">
-<title>Behavior Tab</title>
-
-<para>
-
-<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.
-</para></listitem>
-
-<listitem><para>
-<guilabel>Sorting Mode</guilabel> controls how items are sorted in
-the view. If <guilabel>Natural sorting</guilabel> is enabled, the sort order of three example files
-will be
-<orderedlist>
-<listitem><para>File1,</para></listitem>
-<listitem><para>File2,</para></listitem>
-<listitem><para>File10.</para></listitem>
-</orderedlist>
-If this option is disabled, the normal alphabetical sorting case sensitive or case insensitive
-will be used, which leads to the sort order
-<orderedlist>
-<listitem><para>File1,</para></listitem>
-<listitem><para>File10,</para></listitem>
-<listitem><para>File2.</para></listitem>
-</orderedlist>
-</para></listitem>
-
-<listitem><para>
-When hovering over a file or folder with the mouse, a small window with relevant
-information is shown if <guilabel>Show tooltips</guilabel> is enabled.
-</para></listitem>
-
-<listitem><para>
-<guilabel>Show selection marker</guilabel> shows a small <guibutton>+</guibutton>
-or <guibutton>-</guibutton> button above an item's icon if the item is hovered over
-with the mouse. These can be used to select or deselect the item.
-</para></listitem>
-
-<listitem><para>
-Enable <guilabel>Rename inline</guilabel> to use this mode if only one item is currently selected.
-If this option is disabled or several items are selected, a dialog will be displayed for renaming.
-</para></listitem>
-
-</itemizedlist>
-
-</para>
-
-</sect3>
-
-<sect3 id="preferences-dialog-general-previews">
-<title>Previews Tab</title>
-
-<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.
-</para>
-<para>
-If previews are enabled for folders, previews of some files in the folder will
-be shown inside a folder's icon.
-</para>
-</sect3>
-
-<sect3 id="preferences-dialog-general-confirmations">
-<title>Confirmations Tab</title>
-<para>
-In the ask for confirmation section, you can enable warning dialogs that
-are shown before potentially harmful actions .
-</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,
-whereas <guilabel>Closing Dolphin windows
- with multiple tabs</guilabel> is a &dolphin; <!--and &konqueror;--> specific setting.</para></warning>
-</sect3>
-
-<sect3 id="preferences-dialog-general-statusbar">
-<title>Status Bar Tab</title>
-
-<para>
-In this tab, some additional items can be enabled for the status bar, provided
-the status bar is wide enough:
-
-<itemizedlist>
-
-<listitem><para>
-A <guilabel>zoom slider</guilabel> which can be used to change the icon size quickly.
-</para></listitem>
-
-<listitem><para>
-A bar that shows how much space is free on the current drive.
-</para></listitem>
-
-</itemizedlist>
-
-</para>
-
-</sect3>
-
-</sect2>
-
</sect1>
<!-- begin copy to konqueror filemanager.docbook -->
<sect1 id="view-properties">
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
current folder including all subfolders, or even for all folders, depending on
-the choice made in the <guilabel>Apply View Properties To</guilabel> section.
+the choice made in the <guilabel>Apply to</guilabel> section.
</para>
<para>
-If <guilabel>Use these view properties as default</guilabel> is enabled, the chosen view
+If <guilabel>Use as default view settings</guilabel> is enabled, the chosen view
properties will also be used for all folders which do not have customized view
properties yet.
</para>
to the trash and cannot be restored.</action></para></listitem>
</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Show Target</guimenuitem>
+</menuchoice></term>
+<listitem><para>This action highlights a link target in a new &dolphin; window.
+</para></listitem>
+</varlistentry>
+
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
-<guimenuitem>Find...</guimenuitem>
+<guimenuitem>Search...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens the find bar. Enter a search term into the edit box and select to search for filename
or in contents of files starting from the current folder or everywhere.</action></para></listitem>
<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></para></listitem>
+folder.</action>There is an alternate shortcut <keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo>
+for this action.</para></listitem>
</varlistentry>
<varlistentry>
<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>
<guimenu>Tools</guimenu>
<guimenuitem>Show Filter Bar</guimenuitem>
</menuchoice></term>
-<listitem><para><action>Enables and disables the <link linkend="filter-files">filter bar</link>.</action></para></listitem>
+<listitem><para><action>Enables and disables the <link linkend="filter-files">filter bar</link>.</action>
+You can also use the alternate shortcut <keycombo action="simul">&Shift;<keycap>/</keycap></keycombo>
+for this action.</para></listitem>
</varlistentry>
<varlistentry>
projects / dolphin.git / blobdiff