[kstars] doc: Update tutorial

[Raphael Cojocaru]

Git commit 2ef514ca98c311701ccbb3187b1ea6e77f78cf3d by Raphael Cojocaru.
Committed on 09/08/2016 at 11:16.
Pushed by raphaelc into branch 'master'.

Update tutorial

M  +22   -15   doc/config.docbook

http://commits.kde.org/kstars/2ef514ca98c311701ccbb3187b1ea6e77f78cf3d

diff --git a/doc/config.docbook b/doc/config.docbook
index 76f0395..5029212 100644
--- a/doc/config.docbook
+++ b/doc/config.docbook
@@ -612,16 +612,23 @@ objects described by a set of parameters, like: ID Number, Right Ascension, Decl
 </important>
 
 <para>
-The following is a subset of the raw data file:
+The following is a subset of the original raw data file:
 
 <programlisting>
-1 16:26:0 -16:0:0.1 13.943 5
-2 18:4:0 -31:30:0.1 66.813 5
-3 18:0:0 -31:0:0.1 141.986 5
-4 16:59:5 -22:8:0.1 3.795 5
-5 17:13:2 -24:22:0.2 6.573 5
+   1 16 26.0   -16  0    .18 +21.82    .054 3  49    8  452
+   2 18  4.0   -31 30    .13 -05.32   1.240 2   0    4  837
+   3 18  0.0   -31  0    .15 -04.33   5.600 2   0    6  817
+   4 16 59.5   -22  8    .18 +11.82    .004 5  27    7  533
+   5 17 13.2   -24 22    .20 +07.96    .012 4   0    9  595
 </programlisting>
 
+The raw file contains some extra information, unusable for &kstars;. It also contains extra white spaces 
+and values are not meeting &kstars; expectations (&ie; for Right Ascension: colon-delimited hh:mm:ss.s 
+or floating-point value). Thus, it need to be modified in order to match &kstars; format. 
+For a better understanding on what each column means, you can take a look at 
+<ulink url="ftp://cdsarc.u-strasbg.fr/cats/VII/7A/">the original source</ulink> of the catalog. 
+It contains the raw data file and, in adittion, it contains an useful readme, which will help 
+you understand what you should keep and furthermore, what you need to remove from the raw data file. 
 Minimally, the raw data file should contain the following fields:
 <itemizedlist>
 <listitem><para>ID Number</para></listitem>
@@ -633,15 +640,15 @@ Minimally, the raw data file should contain the following fields:
 </para>
 
 <para>
-The raw <quote>Dark Nebulae by Lynds</quote> contains only Right Ascension, Declination 
-and Area (square degrees). Therefore, in order to properly import the catalog 
-into &kstars;, the ID and Object Type fields need to be added. You can insert these values 
-manually using your favorite text editor. However, it is recommended to use any spreadsheet 
-application to import the raw data file and add the necessary columns. This is especially 
-convenient for large data sets. Since the original raw data contains an area field which 
-is not supported by &kstars;, we need to approximate it to a usable value which is the 
-Major Axis. Therefore, we use the following formula in the spreadsheet to convert area 
-to major axis in arcminutes:
+The raw <quote>Dark Nebulae by Lynds</quote> contains only three usable fields for &kstars;:
+Right Ascension, Declination and Area (square degrees). Therefore, in order to properly 
+import the catalog into &kstars;, the ID and Object Type fields need to be added. You can 
+insert these values manually using your favorite text editor. However, it is recommended 
+to use any spreadsheet application to import the raw data file and add the necessary 
+columns. This is especially convenient for large data sets. Since the original raw data 
+contains an area field which is not supported by &kstars;, we need to approximate it to a 
+usable value which is the Major Axis. Therefore, we use the following formula in the 
+spreadsheet to convert area to major axis in arcminutes:
 <constant>Major Axis = sqrt(Area) * 60</constant>
 </para>