[DOC] Improve Trackpoint edit dialog description and add example image.

diff --git a/help/C/figures/Trackpoint_edit_dialog.png b/help/C/figures/Trackpoint_edit_dialog.png
new file mode 100644 (file)
index 0000000..c2da03a
Binary files /dev/null and b/help/C/figures/Trackpoint_edit_dialog.png differ

diff --git a/help/C/viking.xml b/help/C/viking.xml
index e0fc3923ea039172dce88e7d23b36b775ff72f8e..8318726fd499b353c8a13b8f49a2078b274ba467 100644 (file)
--- a/help/C/viking.xml
+++ b/help/C/viking.xml
@@ -1035,10 +1035,14 @@ This is not available on routes as they do not have route segments.
 </note>
 </section>
 
-<section><title>Split at Trackpoint</title>
+<section id='trkpt_split' xreflabel="Split at Trackpoint"><title>Split at Trackpoint</title>
 <para>
 Splits the track at the currently selected trackpoint.
 </para>
+<para>
+The current track will finish at this trackpoint.
+A new track will start from a copy of this trackpoint.
+</para>
 <note>
 <para>
 This is only enabled when a trackpoint is selected.
@@ -1147,6 +1151,17 @@ This is not available on routes.
 </note>
 </section>
 
+<section><title>Edit Trackpoint</title>
+<para>
+This opens the Trackpoint edit dialog. See <xref linkend="Trackpoint_edit"/>.
+</para>
+<note>
+<para>
+This is only enabled when a trackpoint is selected.
+</para>
+</note>
+</section>
+
 <section><title>Refine Route...</title>
 <para>
 This function allows to request a Routing Engine in order to refine a given route.
@@ -1601,10 +1616,39 @@ Left click near a trackpoint (in screen pixel terms) to bring up the Track Point
 Whilst the edit dialog is already open, left click again and drag enables moving of the trackpoint.
 If <keycap>Ctrl</keycap> is held at the same time, it will jump the new trackpoint position to a nearby existing trackpoint.
 </para>
+<section id="Trackpoint_edit" xreflabel="Edit Trackpoint Dialog"><title>Edit Trackpoint Dialog</title>
 <para>
-Options in the Track Point Edit dialog include: change position, go to next, go to previous, delete, insert (halfway to next trackpoint) and splitting the track.
+Editing options in the Trackpoint Edit dialog include:
+<itemizedlist>
+<listitem>Edit the trackpoint name</listitem>
+<listitem>Changing raw lat/long position and altitude</listitem>
+<listitem>Forward (go to the next trackpoint)</listitem>
+<listitem>Back (go to the previous trackpoint)</listitem>
+<listitem>Delete</listitem>
+<listitem>Insert. Inserts a point halfway to next trackpoint</listitem>
+<listitem>Split. <xref linkend="trkpt_split"/></listitem>
+</itemizedlist>
+</para>
+<para>
+Several fields are read only for reference purposes, values are shown if the trackpoint has such information:
+<itemizedlist>
+<listitem>Time.</listitem>
+<listitem>Speed and course.</listitem>
+<listitem>'Between' values: Speed, Time Difference and Distance Difference. When moving between trackpoints (via the Back and Forward buttons) these values are calculated.</listitem>
+<listitem>GPS precision factors.</listitem>
+</itemizedlist>
+</para>
+<para>
+<figure>
+<title>Trackpoint Edit Dialog: Example</title>
+<screenshot>
+  <graphic format="PNG" fileref="figures/Trackpoint_edit_dialog.png"/>
+</screenshot>
+</figure>
+One must have been going downhill here to get a reasonable speed by bicycle!
 </para>
 </section>
+</section>
 
 <section><title>Show Picture</title>
 <para>

diff --git a/help/Makefile.am b/help/Makefile.am
index 94f5557eb91a8b46041c2796ac006e12013853f7..43df62e88586c27b0d075990f09990c34ee3233d 100644 (file)
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -31,6 +31,7 @@ DOC_FIGURES = \
     figures/ruler_18.png \
     figures/select_18.png \
     figures/showpic_18.png \
+    figures/Trackpoint_edit_dialog.png \
     figures/trw_statusbar.png \
     figures/vik_new_route_18.png \
     figures/zoom_18.png \