Merge branch 'release/19.12'

[dolphin.git] / doc / index.docbook

diff --git a/doc/index.docbook b/doc/index.docbook
index 3495ee9bcfe711d218a2f8a04ef972756d60a0b4..7dcf9ec1742fe3456078d52902a31d43c29f6ecc 100644 (file)
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -70,8 +70,8 @@
 
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2019-02-17</date>
-<releaseinfo>Applications 19.04</releaseinfo>
+<date>2019-09-30</date>
+<releaseinfo>Applications 19.12</releaseinfo>
 
 <abstract>
 <para>
@@ -189,7 +189,7 @@ The <link linkend="places-panel"><guilabel>Places</guilabel> panel</link>, which
 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>
@@ -312,7 +312,7 @@ The buttons in the toolbar which control the appearance of the view.
 All the settings discussed below and other options concerning, &eg; 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.
@@ -610,11 +610,11 @@ programs built into &kde; which add support for many different protocols to
 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>
@@ -681,7 +681,7 @@ the path starting with the current places entry.
 
 <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>
@@ -690,7 +690,7 @@ to a different position, even outside the window.
 <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
@@ -951,11 +951,11 @@ using the <link linkend="preferences-dialog">Preferences Dialog</link>.
 
 <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>
@@ -1008,9 +1008,9 @@ tab bar at the top.
 <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>
@@ -1078,11 +1078,14 @@ be shown inside a folder's icon.
 <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>
@@ -1171,6 +1174,10 @@ for details.
 <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>
@@ -1405,7 +1412,7 @@ largest files can be deleted automatically.
 </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
@@ -1447,31 +1454,31 @@ What additional information (besides the name) is shown in the Icons or Details
 
 </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>
@@ -1754,6 +1761,17 @@ Selects all unselected items and deselects all selected items in the current fol
 <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>
@@ -1780,7 +1798,7 @@ or other criteria described in <link linkend="dolphin-view-information">Informat
 <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>.
@@ -1790,7 +1808,7 @@ described in <link linkend="dolphin-view-information">Information in the View</l
 <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>
@@ -1812,7 +1830,7 @@ current folder grouped by the option selected in <guimenuitem>Sort By</guimenuit
 <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>
@@ -1853,7 +1871,7 @@ folder.</action></para></listitem>
 <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>
@@ -1899,9 +1917,9 @@ if necessary, and selects the location such that it can be replaced quickly.
 <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>
@@ -2000,6 +2018,17 @@ for this action.</para></listitem>
 <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>
@@ -2025,8 +2054,8 @@ connection manually.</action></para></listitem>
 <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>