[marble] doc: Added doc about recording a movie with Marble

[Albert Astals Cid]

Git commit 45360c6fffcdd1edccbbc17b7805450039cd31fd by Albert Astals Cid, on behalf of Sergey Popov.
Committed on 21/01/2017 at 00:56.
Pushed by aacid into branch 'master'.

Added doc about recording a movie with Marble

REVIEW: 121705

M  +53   -1    doc/index.docbook

https://commits.kde.org/marble/45360c6fffcdd1edccbbc17b7805450039cd31fd

diff --git a/doc/index.docbook b/doc/index.docbook
index 895e446fd..9985aadf4 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -499,7 +499,39 @@
          </para>
          <para>
            You can keep using &marble; while the <guilabel>Download Region</guilabel> dialog is open. This is useful to queue several downloads for different regions or different tile ranges. Just select <guilabel>Apply</guilabel> instead of <guilabel>OK</guilabel> to trigger the map region download.
-         </para>
+         </para>	 
+     <chapter id="recording-movie">
+       <sect1 id="recording-movie-recording">
+	 	<title>Recording a movie with &marble;</title>
+	 	<para>
+	 	  To record a movie with Marble, use this function for recording.
+	 	</para>
+	 	<para>
+	 	  Begin recording from the <guilabel>Record Movie</guilabel> dialog in the <guilabel>Edit</guilabel> menu. Or you can start it by pressing <keycombo>Ctrl + Shift + R</keycombo>. You will see a dialog like this:
+	 	</para>
+	 	<screenshot>
+         	    <screeninfo>&marble; Record Movie dialog</screeninfo>
+         	    <mediaobject>
+         	        <imageobject><imagedata fileref="movie-1.png" format="PNG" /></imageobject>
+         	        <textobject><phrase>&marble;'s Record Movie dialog</phrase></textobject>
+         	    </mediaobject>
+         	</screenshot>
+	 	<para>
+	 	  Press the <guilabel>Open</guilabel> button to choose the name and destination directory of the movie. Also you can change the frames per second (FPS) of the movie between 1 and 60.
+	 	</para>
+		<para>
+		  When all is set, you can start recording. To start, click the <guilabel>Start</guilabel> button. Once this is done you can zoom and pan around and Marble will capture a video of your journey across the globe.
+		</para>
+	 	<para>
+	 	  To stop recording of the movie and save it, click <guilabel>Stop Recording</guilabel> in the <guilabel>Edit</guilabel> menu or press <keycombo>Ctrl + Shift + S</keycombo>.
+	 	</para>
+	</sect1>
+	<sect2 id="recording-movie-troubleshooting">
+	  <title>Troubleshooting</title>
+	  <para>
+	    There may appear an error message because avconv or ffmpeg are not installed. Download from <link linkend="http://ffmpeg.org/download.html">ffmpeg's downloads page</link> and <link linkend="https://libav.org/download.html">avconv's downloads page</link> or use packages from your distribution.
+	  </para>
+	</sect2>
      </chapter>
 
 	 <chapter id="commands">
@@ -638,6 +670,26 @@
                          </menuchoice></term>
 			 <listitem><para><action>Allows</action> you to open the current map in the external map editor. The current version supports <application>Potlatch</application> (in a web browser), <application>Merkaartor</application> and <application>JOSM</application> map editors.</para></listitem>
                      </varlistentry>
+		     <varlistentry>
+                         <term><menuchoice>
+			         <shortcut>
+                                     <keycombo action="simul">&Ctrl; &Shift;<keycap>R</keycap></keycombo>
+                                 </shortcut>
+                                 <guimenu>Edit</guimenu>
+                                 <guimenuitem>Record Movie</guimenuitem>
+                         </menuchoice></term>
+                         <listitem><para><action>Records</action> a movie with Marble.</para></listitem>
+                     </varlistentry>
+		     <varlistentry>
+                         <term><menuchoice>
+                                 <shortcut>
+                                     <keycombo action="simul">&Ctrl; &Shift;<keycap>S</keycap></keycombo>
+                                 </shortcut>
+			         <guimenu>Edit</guimenu>
+                                 <guimenuitem>Stop Recording</guimenuitem>
+                         </menuchoice></term>
+                         <listitem><para><action>Stops</action> the current recording of movie.</para></listitem>
+                     </varlistentry>
                  </variablelist>
 
              </sect2>