[spectacle] doc: Update Spectacle docbook to reflect recent changes

[Nathaniel Graham]

Git commit c6a767100086f882046b5b3a2d2fb0dd0098875d by Nathaniel Graham.
Committed on 31/01/2018 at 18:16.
Pushed by ngraham into branch 'master'.

Update Spectacle docbook to reflect recent changes

Summary: Updates the docbook to reflect the last few commits' worth of changes, and also tweaks a few other things to offer more clarity.

Reviewers: #spectacle, rkflx, rkron

Reviewed By: rkflx

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

M  +7    -3    doc/index.docbook

https://commits.kde.org/spectacle/c6a767100086f882046b5b3a2d2fb0dd0098875d

diff --git a/doc/index.docbook b/doc/index.docbook
index d4fc8d1..07df632 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -111,13 +111,17 @@
 
 		<para>The snapshot taken by &spectacle; is displayed in the preview window, which is located on the left-hand side of the &spectacle; application window.</para>
 
-		<para>To quickly save the image and quit &spectacle; press the <guibutton>Save & Exit</guibutton> (<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>) button. By default, this saves the image as a PNG file in your default Pictures folder, and exits the application immediately. The default save location and filename can be configured, as described later.</para>
+		<para>The image can be saved to a location of your choice by clicking on the <guibutton>Save As</guibutton> button or typing <keycombo action="simul">&Ctrl;&Shift;<keycap>S</keycap></keycombo>. This opens the standard save dialog, where you can choose the filename, the folder location, and the format that your screenshot will be saved in. You may edit the filename to anything you wish, including the name of a previously saved screenshot.</para>
 
-		<para>The image can be saved by clicking on the arrow portion of the <guibutton>Save & Exit</guibutton> button, and choosing <guimenuitem>Save As...</guimenuitem> (<keycombo action="simul">&Ctrl;&Shift;<keycap>S</keycap></keycombo>) option. This opens standard save dialog, where you can choose the filename, the folder location, and the format that your screenshot will be saved in. You may edit the filename to anything you wish, including the name of a previously saved screenshot. You may also select the <guimenuitem>Save...</guimenuitem> (<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>) option, which will save the image to its default location and with the default filename.</para>
+		<para>To save a screenshot to the default location, click on the arrow portion of the <guibutton>Save As...</guibutton> button and press the <guimenuitem>Save </guimenuitem> (<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>) button. The new save mode will be remembered for next time; this behavior can be configured in Spectacle's settings. The default save location and filename can also be configured there, as described later.</para>
+
+		<para>To quickly save the image and quit &spectacle;, click on the arrow portion of the <guibutton>Save As...</guibutton> button and press the <guimenuitem>Save & Exit</guimenuitem> (<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>) item. This saves the image as a PNG file in your default Pictures folder, and exits the application immediately. As above, this new save mode will be remembered.</para>
 
 		<sect1 id="taking-screenshot">
 			<title>Taking A Screenshot</title>
 
+			<para>When you open spectacle, it immediately takes a screenshot of the whole screen as a convenience and shows a preview of it in the main window. You can save this screenshot using the buttons on the bottom of the window, or take a new one using the controls to the right of the preview.</para>
+
 			<para>To discard the current screenshot and take another screenshot, press the <guibutton>Take a New Screenshot</guibutton> (<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>) button.</para>
 
 			<para>You may configure certain options on the right hand side of the application window before taking a new screenshot. These options allow you to select the area of the screen that is to be captured, set a delay before capturing the image, and configure whether the mouse cursor and/or the window decorations should be captured along with the screenshot.</para>
@@ -239,7 +243,7 @@
 				<varlistentry>
 					<term><guilabel>Remember last used Save mode</guilabel></term>
 					<listitem>
-						<para>The default behavior of the save button is to <guibutton>Save & Exit</guibutton>. Enable this option to make the button remember the last used save command so you don't need to open the dropdown menu to access it. This is useful if you want to take multiple screenshots and use <guimenuitem>Save As...</guimenuitem> to give them unique names or save them to different places.</para>
+						<para>The default behavior of the save button is to display <guibutton>Save As</guibutton>. Choosing another save mode by clicking on the arrow portion of the button will make that save mode the default one. Disable this option to make the button stop remembering the last used save mode</para>
 					</listitem>
 				</varlistentry>
 				<varlistentry>