[education/kstars] doc: Small update to the Scheduler docbook for the Mosaic Tool.

[Jasem Mutlaq]

Git commit 4199047fd69c9c39f0c041edff13d5190c255a44 by Jasem Mutlaq, on behalf of Eric Dejouhanet.
Committed on 17/05/2021 at 18:22.
Pushed by mutlaqja into branch 'master'.

Small update to the Scheduler docbook for the Mosaic Tool.

M  +5    -2    doc/ekos-scheduler.docbook

https://invent.kde.org/education/kstars/commit/4199047fd69c9c39f0c041edff13d5190c255a44

diff --git a/doc/ekos-scheduler.docbook b/doc/ekos-scheduler.docbook
index 7337ad002..3c78c55a0 100644
--- a/doc/ekos-scheduler.docbook
+++ b/doc/ekos-scheduler.docbook
@@ -329,13 +329,16 @@ exit(0)
             The 2nd step is handled by image processing applications such as <ulink url="https://pixinsight.com">PixInsight</ulink>, among others, and will not be the topic of discussion here. The first step can be accomplished in Ekos Scheduler where it creates a mosaic suitable for your equipment and in accordance with the desired field of view. Not only Ekos creates the mosaic panels for your target, but it also constructs the corresponding observatory jobs required to capture all the images. This greatly facilitates the logistics of capturing many images with different filters and calibration frames across a wide area of the sky.
         </para>
         <para>
-            Before starting the <guilabel>Mosaic Job Creator</guilabel> in Ekos Scheduler, you need to select a target and a sequence file. The Sequence File contains all the information necessary to capture an image including exposure time, filters, temperature setting, &etc; Start the Mosaic Job Creator by clicking on the icon next to the <guibutton>Find</guibutton> button in Ekos Module.
+            Before starting the <guilabel>Mosaic Job Creator</guilabel> in Ekos Scheduler, you need to select a target and a sequence file. The Sequence File contains all the information necessary to capture an image including exposure time, filters, temperature setting, &etc; Check that all the observation job conditions, constraints, and startup/shutdown procedures are as per your requirements since these settings shall be copied to all the jobs generated by the Mosaic tool. You do not need to add a job with this information ; if you added jobs to the observation list previously, Ekos will ask you if you would want to keep them before inserting the mosaic jobs in the list.
+        </para>
+        <para>
+            Start the Mosaic Job Creator by clicking on the icon next to the <guibutton>Find</guibutton> button in Ekos Module. A new window will open with a left-side form and your target centered in a sky chart. For convenience, maximize that window. There is a help icon on the top left part of the sky chart. Move your mouse over it to display the latest documentation of the tool.
         </para>
         <para>
             On first use, you need to enter your equipment settings including your telescope focal length in addition to camera's width, height, and pixel dimensions. Finally, you need to enter the rotation of the camera with respect to north or the position angle. If you don't know this value, start Ekos and slew to your desired target then use the <link linkend="ekos-align">Align module</link> to solve the image and obtain the position angle.
         </para>
         <para>
-            Next, enter the desired number of horizontal and vertical panels (⪚ 2x2, 3x3, &etc;) and then click <guibutton>Update</guibutton>. The target FOV shall be calculated given the number of panels and your camera's FOV and the mosaic overlap shall be displayed. By default, the percentage of the overlap among images is 5%, but you can change this value to your desired value. You can also move the complete mosaic structure around to fine tune the position of the mosaic panels. When satisfied, click <guibutton>Create Jobs</guibutton> and Ekos shall create an observation job and a corresponding customized sequence file for each panel. All the jobs shall be saved to an Ekos Scheduler List (<filename role="extension">.esl</filename>) file that you can load on any suitable observing night and it will pick off where you left. Before starting the <guilabel>Mosaic Job Creator</guilabel>, check that all the observation job conditions, constraints, and startup/shutdown procedures are as per your requirements since these settings shall be copied to all the jobs generated by the Mosaic tool.
+            Next, enter the desired overlap and number of horizontal and vertical panels (⪚ 2x2, 3x3, &etc;). The sky chart will update automatically after a short time, with target FOV calculated given the number of panels and your camera's FOV. By default, the percentage of the overlap among images is 5%, but you can change this value to your desired value. If you need to move the mosaic, close the tool and select a new target in the Scheduler. When satisfied, set the frequency of alignment and focus steps during the mosaic execution, choose an output folder and accept the dialog. Ekos shall create an observation job and a corresponding customized sequence file for each panel. All the jobs shall be saved to an Ekos Scheduler List (<filename role="extension">.esl</filename>) file that you can load on any suitable observing night and it will pick off where you left.
         </para>
         <para>
             With Ekos Scheduler, multi-night imaging is greatly facilitated and creating super mosaics has never been so easy.