Merge branch 'Applications/18.04'

[dolphin.git] / doc / index.docbook

diff --git a/doc/index.docbook b/doc/index.docbook
index 3749831abe3ba169266bcb909a87434696c09a58..c2ed2854f480a7f6dab47ad9f3b20455e46889db 100644 (file)
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1,7 +1,5 @@
 <?xml version="1.0" ?>
 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
 <?xml version="1.0" ?>
 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [

-  <!ENTITY dolphin "<application>Dolphin</application>">
-  <!ENTITY kappname "&dolphin;">

   <!ENTITY % addindex "IGNORE">
   <!ENTITY % English "INCLUDE"><!-- change language only here -->
 ]>
   <!ENTITY % addindex "IGNORE">
   <!ENTITY % English "INCLUDE"><!-- change language only here -->
 ]>


@@ -72,12 +70,12 @@
 
 <legalnotice>&FDLNotice;</legalnotice>
 
 
 <legalnotice>&FDLNotice;</legalnotice>
 

-<date>2015-08-02</date>
-<releaseinfo>Applications 15.08</releaseinfo>
+<date>2018-03-26</date>
+<releaseinfo>Applications 18.04</releaseinfo>

 
 <abstract>
 <para>
 
 <abstract>
 <para>

-&dolphin; is the default file manager for &kde;, designed with usability as a primary focus.
+&dolphin; is the default file manager by &kde;, designed with usability as a primary focus.

 </para>
 </abstract>
 
 </para>
 </abstract>
 


@@ -95,7 +93,7 @@
 <title>Introduction</title>
 
 <para>
 <title>Introduction</title>
 
 <para>

-&dolphin; is &kde;'s default file manager. It aims to improve usability at the
+&dolphin; is &plasma;'s default file manager. It aims to improve usability at the

 user interface level. &dolphin; focuses only on being a file manager whereas
 &konqueror;, which was &kde;'s default file manager in &kde; 3 and can still be
 used for file management, is a universal viewer for many file types.
 user interface level. &dolphin; focuses only on being a file manager whereas
 &konqueror;, which was &kde;'s default file manager in &kde; 3 and can still be
 used for file management, is a universal viewer for many file types.


@@ -241,8 +239,8 @@ can be accessed or manipulated in different ways:
 <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>
 <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>
 </para></listitem>
 
 <listitem><para>


@@ -283,6 +281,9 @@ the toolbar can be used to navigate in the history.
 </mediaobject>
 </screenshot>
 
 </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">
 </sect2>
 
 <sect2 id="dolphin-view-appearance">


@@ -357,11 +358,11 @@ the extension is replaced by <quote>...</quote>
 the <guilabel>Name</guilabel> header, which is always the first column in this view.
 </para>
 <para>
 the <guilabel>Name</guilabel> header, which is always the first column in this view.
 </para>
 <para>

-The details view allows you to view the current directory
+The details view allows you to view the current folder

 in a tree-like fashion if <link linkend="preferences-dialog-viewmodes-details">
 in a tree-like fashion if <link linkend="preferences-dialog-viewmodes-details">

-<guilabel>Expandable folders</guilabel></link> are enabled: 
+<guilabel>Expandable folders</guilabel></link> are enabled:

 Each subfolder of the current folder can be
 Each subfolder of the current folder can be

-<quote>expanded</quote> or <quote>collapsed</quote> by clicking on the <guiicon>&gt;</guiicon>
+<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>
 or <guiicon>v</guiicon> icon next to it.</para></listitem>
 </itemizedlist>
 </para>


@@ -386,7 +387,7 @@ in <menuchoice><guimenu>View</guimenu><guisubmenu>Sort by</guisubmenu></menuchoi
 <sect3 id="dolphin-view-information">
 <title>Information in the View</title>
 <para>
 <sect3 id="dolphin-view-information">
 <title>Information in the View</title>
 <para>

-In all view modes &kappname; shows at least an icon and a name for each item. 
+In all view modes &dolphin; shows at least an icon and a name for each item. 

 Using <guisubmenu>Additional Information</guisubmenu> in the <guimenu>View</guimenu> 
 menu or the context menu of the header in <guilabel>Details</guilabel> mode, you can select
 more information for each item to be shown:
 Using <guisubmenu>Additional Information</guisubmenu> in the <guimenu>View</guimenu> 
 menu or the context menu of the header in <guilabel>Details</guilabel> mode, you can select
 more information for each item to be shown:


@@ -725,7 +726,7 @@ over with the mouse, including size, type, and date of last modification. It als
 features a large preview of the selected item and allows you to assign a rating,
 tags, and comments to it.
 </para>
 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">
 </sect2>
 
 <sect2 id="folders-panel">


@@ -735,9 +736,10 @@ tags, and comments to it.
 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.
 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>

-
+<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">
 </sect2>
 
 <sect2 id="terminal-panel">


@@ -776,6 +778,7 @@ current folder, &RMB; click in the work space and click
 <sect2 id="finding-searching-in-file">
 <title>Finding Files and Searching in Files</title>
 <!-- FIXME search in hidden files + folders View -> Show Hidden Files has to be enabled ? -->
 <sect2 id="finding-searching-in-file">
 <title>Finding Files and Searching in Files</title>
 <!-- FIXME search in hidden files + folders View -> Show Hidden Files has to be enabled ? -->

+<!-- https://bugs.kde.org/show_bug.cgi?id=361557 No clear way to open configuration dialog for Baloo search engine -->

 <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> 
 <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> 


@@ -804,7 +807,6 @@ a KIOSlave is launched to provide the search results.</para>
 <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>
 <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>
 <screeninfo>Search with More Options</screeninfo>
 <mediaobject>


@@ -830,6 +832,14 @@ the user to shrink the number of search results.</para>
 together with the <guilabel>Filter</guilabel> bar to find files using Baloo or limit 
 the search to files matching the filter expression.</para>
 
 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">
 </sect2>
 
 <sect2 id="mounting-storage-media">


@@ -854,7 +864,7 @@ in the menu, &eg; <guimenuitem>Undo: Rename</guimenuitem>.
 </para>
 
 </sect2>
 </para>
 
 </sect2>

-
+<!-- FIXME https://phabricator.kde.org/D10698-->

 <sect2 id="batch-rename">
 <title>Renaming A Batch Of Files</title>
 <para>
 <sect2 id="batch-rename">
 <title>Renaming A Batch Of Files</title>
 <para>


@@ -862,7 +872,7 @@ in the menu, &eg; <guimenuitem>Undo: Rename</guimenuitem>.
 will have the file name specified, including a number, &eg;, Image1.jpg,
 Image2.jpg, Image3.jpg. This can be useful, &eg;, for pictures taken with a digital camera.
 </para>
 will have the file name specified, including a number, &eg;, Image1.jpg,
 Image2.jpg, Image3.jpg. This can be useful, &eg;, 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
 <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


@@ -1022,6 +1032,10 @@ startup or not. See the <link linkend="filter-files">section on the filter bar</
 for details.
 </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>

 </itemizedlist>
 
 </para>
 </itemizedlist>
 
 </para>


@@ -1146,16 +1160,9 @@ structure and in archives works.
 <itemizedlist>
 
 <listitem><para>
 <itemizedlist>
 
 <listitem><para>

-&dolphin; can be configured to open items with a single mouse click
-(<guilabel>Single-click to open files and folders</guilabel>) or a double mouse
-click (<guilabel>Double-click to open files and folders</guilabel>). In the
-latter case, a single mouse click will select the file or folder.
-</para>
-<note>
-<para>This is a system wide setting and can be changed in the &systemsettings; in the
-<menuchoice><guimenu>Input Devices</guimenu> <guimenuitem>Mouse</guimenuitem></menuchoice> 
-module as well.</para>
-</note>
+The option to open items with a single or double mouse click is a system wide setting and can be
+changed in the &systemsettings; in the <menuchoice><guimenu>Input Devices</guimenu>
+<guimenuitem>Mouse</guimenuitem></menuchoice> module.</para>

 </listitem>
 
 <listitem><para>
 </listitem>
 
 <listitem><para>


@@ -1295,28 +1302,18 @@ 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>
 <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>
-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>
 
 <listitem><para>

-<guilabel>Natural sorting of items</guilabel> controls how items are sorted in
-the view. If this option is enabled, the sort order of three example files
+<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>
 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 will be used, which
-leads to the sort order
+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>
 <orderedlist>
 <listitem><para>File1,</para></listitem>
 <listitem><para>File10,</para></listitem>


@@ -1325,10 +1322,25 @@ leads to the sort order
 </para></listitem>
 
 <listitem><para>
 </para></listitem>
 
 <listitem><para>

-Enable <guilabel>Rename inline</guilabel> to use this mode if only one item is currently selected. 
+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>
 
 If this option is disabled or several items are selected, a dialog will be displayed for renaming.
 </para></listitem>
 

+<listitem><para><guilabel>Use tab for switching between left and right split view</guilabel>
+allows to switch without using the mouse.
+</para></listitem>
+

 </itemizedlist>
 
 </para>
 </itemizedlist>
 
 </para>


@@ -1357,8 +1369,8 @@ are shown before potentially harmful actions .
 <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, 
 <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>
+whereas <guilabel>Closing Dolphin windows
+with multiple tabs</guilabel> is a &dolphin; specific setting.</para></warning>

 </sect3>
 
 <sect3 id="preferences-dialog-general-statusbar">
 </sect3>
 
 <sect3 id="preferences-dialog-general-statusbar">


@@ -1381,11 +1393,6 @@ A bar that shows how much space is free on the current drive.
 </itemizedlist>
 
 </para>
 </itemizedlist>
 
 </para>

-<note><para>
-Since &dolphin; 4.9 the <guimenuitem>Delete</guimenuitem>,
-<guimenuitem>Copy To</guimenuitem>, and <guimenuitem>Move To</guimenuitem>
-commands of the context menu have to be enabled on the Services page.
-</para></note>

 
 </sect3>
 
 
 </sect3>
 


@@ -1398,7 +1405,7 @@ commands of the context menu have to be enabled on the Services page.
 
 <para>
 The following settings control how the contents of a folder are displayed in the
 
 <para>
 The following settings control how the contents of a folder are displayed in the

-&kappname; view, and are stored on a per-folder basis by default:
+&dolphin; view, and are stored on a per-folder basis by default:

 </para>
 <itemizedlist>
 
 </para>
 <itemizedlist>
 


@@ -1419,7 +1426,7 @@ Sorting of folders and files &ndash; are folders shown first or not?
 <listitem><para>
 Previews &ndash; are they shown instead of icons (based on the settings made in
 <link linkend="preferences-dialog-general-previews"><guilabel>Previews</guilabel>
 <listitem><para>
 Previews &ndash; are they shown instead of icons (based on the settings made in
 <link linkend="preferences-dialog-general-previews"><guilabel>Previews</guilabel>

-tab of &kappname;'s General settings</link>) or not?
+tab of &dolphin;'s General settings</link>) or not?

 </para></listitem>
 
 <listitem><para>
 </para></listitem>
 
 <listitem><para>


@@ -1536,6 +1543,17 @@ folder.</action></para>
 <listitem><para><action>Closes the current tab.</action></para></listitem>
 </varlistentry>
 
 <listitem><para><action>Closes the current tab.</action></para></listitem>
 </varlistentry>
 

+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Undo close tab</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Reopens the last closed tab.</action></para></listitem>
+</varlistentry>
+

 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <varlistentry>
 <term><menuchoice>
 <shortcut>


@@ -1573,6 +1591,15 @@ trash.</action></para></listitem>
 to the trash and cannot be restored.</action></para></listitem>
 </varlistentry>
 
 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>
 <varlistentry>
 <term><menuchoice>
 <shortcut>


@@ -1584,7 +1611,7 @@ to the trash and cannot be restored.</action></para></listitem>
 <listitem><para><action>Shows the properties dialog for the currently selected
 item(s).</action></para></listitem>
 </varlistentry>
 <listitem><para><action>Shows the properties dialog for the currently selected
 item(s).</action></para></listitem>
 </varlistentry>

-
+<!--FIXME http://www.aelog.org/checksums-made-easy in fundamentals? -->

 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <varlistentry>
 <term><menuchoice>
 <shortcut>


@@ -1644,7 +1671,10 @@ item(s).</action></para></listitem>
 <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
 </shortcut>
 <guimenu>Edit</guimenu>
 <keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo>
 </shortcut>
 <guimenu>Edit</guimenu>

-<guimenuitem>Paste Clipboard Contents...</guimenuitem>
+<guimenuitem>Paste Clipboard Contents...</guimenuitem></menuchoice> or
+<menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste one File</guimenuitem></menuchoice> or
+<menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste one Folder</guimenuitem></menuchoice> or
+<menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste x Items</guimenuitem>

 </menuchoice></term>
 <listitem><para><action>Pastes the currently copied/cut items to the current
 folder. If the clipboard does not contain files or folders, the clipboard
 </menuchoice></term>
 <listitem><para><action>Pastes the currently copied/cut items to the current
 folder. If the clipboard does not contain files or folders, the clipboard


@@ -1778,10 +1808,11 @@ current folder grouped by the option selected in <guimenuitem>Sort By</guimenuit
 <keycombo action="simul">&Alt;<keycap>.</keycap></keycombo>
 </shortcut>
 <guimenu>View</guimenu>
 <keycombo action="simul">&Alt;<keycap>.</keycap></keycombo>
 </shortcut>
 <guimenu>View</guimenu>

-<guimenuitem>Show Hidden Files</guimenuitem>
+<guimenuitem>Hidden Files</guimenuitem>

 </menuchoice></term>
 <listitem><para><action>Shows all the hidden files and sub-folders within the current
 </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>
 
 <varlistentry>


@@ -1949,7 +1980,9 @@ be reopened.</action></para></listitem>
 <guimenu>Tools</guimenu>
 <guimenuitem>Show Filter Bar</guimenuitem>
 </menuchoice></term>
 <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>
 </varlistentry>
 
 <varlistentry>


@@ -2102,21 +2135,6 @@ Documentation copyright 2009 Frank Reininghaus <email>frank78ac@googlemail.com</
 
 </chapter>
 
 
 </chapter>
 

-<appendix id="installation">
-<title>How to get &dolphin;</title>
-
-&install.intro.documentation;
-
-<para>For instructions on acquiring &kde; please see <ulink
-url="http://www.kde.org">http://www.kde.org</ulink> or read the chapter 
-<ulink url="help:/fundamentals/install.html">Installing &kde;</ulink> 
-in the &kde; Fundamentals.</para>
-
-<para>For further information about &dolphin; you might want to visit
-<ulink url="http://userbase.kde.org/Dolphin">http://userbase.kde.org/Dolphin</ulink>.</para>
-
-</appendix>
-

 &documentation.index;
 </book>
 
 &documentation.index;
 </book>