Update docs for startup page of configuration

Summary: After several resurfaces of GUI the current docs are not up-to-date.

Test Plan: I used an impression from D11382 to write this. Tested with checkXML5. An updated screenshot is needed.

Reviewers: #dolphin, ngraham

Reviewed By: #dolphin, ngraham

Subscribers: ngraham, kfm-devel, kde-doc-english

Tags: #dolphin, #documentation

Differential Revision: https://phabricator.kde.org/D29220

diff --git a/doc/index.docbook b/doc/index.docbook
index d1342d0d479c60dcdf049e01e81762d4ea946580..308fdcbfccfd07f246d74a1c72e2928a7f51730b 100644 (file)
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -70,8 +70,8 @@
 
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2020-03-17</date>
-<releaseinfo>Applications 20.04</releaseinfo>
+<date>2020-04-27</date>
+<releaseinfo>Applications 20.08</releaseinfo>
 
 <abstract>
 <para>
@@ -1137,26 +1137,55 @@ This group contains settings which control the appearance of &dolphin; on startu
 <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>Editable location bar</guilabel> controls if the location bar is in
+<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>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.
@@ -1164,20 +1193,11 @@ Otherwise, a shortened version of the path is shown if it begins with the path o
 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>
 
-<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>

diff --git a/doc/preferences-startup.png b/doc/preferences-startup.png
index 2b780a4c1e6abff12f337bc12cd19b35807997d6..192efe193f74ee3ccdaf06622bac43802b92d492 100644 (file)
Binary files a/doc/preferences-startup.png and b/doc/preferences-startup.png differ