diff --git a/ChangeLog b/ChangeLog
index 3da8a8a23d8cca91e3e1e8840f5e60883f26dac9..eb3e1f57b974c4d4be075b405c53f04b2adc243b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,15 @@
+2015-06-17 Jana Mendrok <jana.mendrok@ltu.se>
+
+	* ARTS-XML-DATA-2-3-12
+
+	* spectroscopy/Perrin/README, scattering/README,
+	planets/Venus/SAT/README, planets/Mars/SAT/README:
+	READMEs for folders missing them so far.
+
+	* spectroscopy/Perrin_artscat34/README, planets/Venus/MPS/README,
+	planets/Mars/MPS/README, planets/Earth/Fascod/README:
+	Minor corrections/updates.
+
 2015-06-17 Jana Mendrok <jana.mendrok@ltu.se>
 
 	* ARTS-XML-DATA-2-3-11
diff --git a/planets/Earth/Fascod/README b/planets/Earth/Fascod/README
index 41072f557b6f53bc5301862a3e8aabf547e77890..23f102dca82e64bd0ed8c4601582f29f21fdc33f 100644
--- a/planets/Earth/Fascod/README
+++ b/planets/Earth/Fascod/README
@@ -3,7 +3,7 @@ This directory contains t/z/vmr field data from the FASCOD model
 - 5 atmospheric scenarios for different seasons and geographic locations (out of originally 6 scenarios - US Standard is currently missing)
 - 1D fields given 0-95km (originally: 0-120km)
 
-- complemented by "expanded" t/z fields covering altitudes up to 2000km. These have been consistently created for use with the IRI and IGRF data, assuming hydrostatic equilibrium and a constant temperature (within the profile as well as for all the 5 scenarios) at altitudes above 95km. NOTE: When using these data, it is highly recommended to use ARTS' z_fieldFromHSE method for adjusting the calculations z_field to hydrostatic equilibrium conditions (the ARTS internal z-over-p interpolation does not conserve this; enforcing hydrostatic equilibrium by applying z_fieldFromHSE brings back the z data closer to the original profile).
+- complemented by "expanded" t/z fields covering altitudes up to 2000km. These have been consistently created for use with the IRI and IGRF data, assuming hydrostatic equilibrium and a constant temperature (within the profile as well as for all the 5 scenarios) at altitudes above 95km. NOTE: When using these data, it is highly recommended to use ARTS' z_fieldFromHSE method for adjusting the calculation z_field to hydrostatic equilibrium conditions (the ARTS internal z-over-p interpolation does not conserve this; enforcing hydrostatic equilibrium by applying z_fieldFromHSE brings back the z data closer to the original profile).
 
 - for more on original data see:
 Anderson, G. P., S. A. Clough, F. X. Kneizys, J. H. Chetwynd, and E. P. Shettle (1986), AFGL atmospheric constituent profiles (0–120 km), AFGL, TR-86-0110.
diff --git a/planets/Mars/MPS/README b/planets/Mars/MPS/README
index 4b1980aadcab80fae4d352fbf67a903c009853db..97e61597914064acea112a64846aa3a3cf338574 100644
--- a/planets/Mars/MPS/README
+++ b/planets/Mars/MPS/README
@@ -1,7 +1,7 @@
 This directory contains planet characterization data (atmospheric profiles,
 surface properties, and the like) for Mars
 
-Mars.meanRefIndex.n.xml
+Mars.surface_complex_refr_index_field.xml
 -----------------------
 - global field of surface refractive index
 - originating from dielectric constant data (real part only; hence imag. part
diff --git a/planets/Mars/SAT/README b/planets/Mars/SAT/README
new file mode 100644
index 0000000000000000000000000000000000000000..86073e1ad668ea89d36cc49f421d226c0c5a542c
--- /dev/null
+++ b/planets/Mars/SAT/README
@@ -0,0 +1,28 @@
+This directory contains cloud and dust data (single scattering properties and
+particle number density fields) for Mars
+
+Mars.Ls[0,90,180,270].[day,night].dust-[low,medium,high]/*.pnd_field__*.xml
+-----------------------
+- 1D number density fields for different cloud/dust types and cases
+- available for 4 seasons, day/night, and 3 dust loadings (corresponding to
+   atmospheric cases, except negligible dependence on solar activity; note that
+   atm case dependence only refers to different p-z-relation during
+   seasons/daytimes; it does so far NOT consider different cloud/dust conditions
+   in different seasons/daytimes)
+- data created by J. Mendrok (LTU) within ESA Planetary study
+- for more details see TechnicalNote3 of the ESA Planetary study
+
+Mars.scat_data__*.xml
+-----------------------
+- single scattering data for different cloud/dust types and cases
+- data created by J. Mendrok (LTU) within ESA Planetary study
+- for more details see TechnicalNote3 of the ESA Planetary study
+
+NOTE: single scattering data and number density fields form paired groups, which
+ are linked by cloud category (CO2ice or H2Oice or Dust) and bulk type (e.g.,
+ *-size-bulk). within the groups, one can choose different dielectric property
+ assumptions (RI-*) for the single scattering data and different altitude
+ distributions (e.g., *-mixed, *-profile) for the number density fields.
+See Consolidated Design Document of the ESA Planetary study for details on the
+ relation of single scattering and number density data and on the file name
+ layout.
diff --git a/planets/Venus/MPS/README b/planets/Venus/MPS/README
index f582f0b570c358ab6570b2e6eb238857cfddbfb7..31095deb903cbf48bbac5009fcdc05988d43c1c5 100644
--- a/planets/Venus/MPS/README
+++ b/planets/Venus/MPS/README
@@ -2,14 +2,14 @@ This directory contains planet characterization data (atmospheric profiles,
 surface properties, and the like) for Venus provided by MPS within ESA Planetary
 study. For more details see TechnicalNote2 of the ESA Planetary study.
 
-Venus.meanRefIndex.n.xml
+Venus.surface_complex_refr_index_field.xml
 ------------------------
 - global field of surface refractive index
 - originating from dielectric constant data (real part only; hence imag. part
 set to 0)
 - for more details see TechnicalNote2 of the ESA Planetary study
 
-Mars.t_surface.xml
+Venus.t_surface.xml
 -----------------------
 - global field of surface (=skin) temperature
 - single, mean condition field
@@ -31,7 +31,7 @@ For a couple of reasons finally selected data is taken from a number of differen
 
 - We need, however consistent, full-coverage (i.e., covering both the vmr and el.dens. regions) z and T data. This is available from the latest (ext*) data sets, hence we get z and T fields from those instead of merging them ourselves from the original data, where vmr/T and el.dens. come with their own z fields.
 
-- In the orginal el.dens. data, there are only 3 sets (day, night, night_cold) instead of the 5 scenarios (vira.day, vira.day_highlat, vira.night, spicav.night, spicav.night_cold) given, and assignment between the 3 and 5 cases is not claer. The latest (ext*) el.dens. data set contains data for all 5 scenarios (though originally sorted into day/ and night/ folders instead of into the 5 scenario folders) and seems to agree well with the T-fields for the different cases (assuming/indicating the el.dens.-over-z is not scenario dependend). Hence, we take the el.dens. fields from the ext* data.
+- In the orginal el.dens. data, there are only 3 sets (day, night, night_cold) instead of the 5 scenarios (vira.day, vira.day_highlat, vira.night, spicav.night, spicav.night_cold) given, and assignment between the 3 and 5 cases is not clear. The latest (ext*) el.dens. data set contains data for all 5 scenarios (though originally sorted into day/ and night/ folders instead of into the 5 scenario folders) and seems to agree well with the T-fields for the different cases (assuming/indicating the el.dens.-over-z is not scenario dependend). Hence, we take the el.dens. fields from the ext* data.
 
 
 In the following we document, which version (date) of the individual data is taken:
diff --git a/planets/Venus/SAT/README b/planets/Venus/SAT/README
new file mode 100644
index 0000000000000000000000000000000000000000..694eef7f9e0d69cdd9c34fd48502d65b7c04928f
--- /dev/null
+++ b/planets/Venus/SAT/README
@@ -0,0 +1,26 @@
+This directory contains cloud and haze data (single scattering properties and
+particle number density fields) for Venus
+
+Venus.[vira,spicav].[day,day_highlat,night,night_cold]/*.pnd_field__*.xml
+-----------------------
+- 1D number density fields for different cloud/haze layers, modes, and cases
+- available for 5 scenarios from different data sources (VIRA and SPICAV),
+  for 2 times of day (day,night). note that scenario dependence only refers to
+  different p-z-relation; it does so far NOT reflect possible different cloud
+  conditions, e.g., in different daytimes.
+- data created by J. Mendrok (LTU) within ESA Planetary study
+- for more details see TechnicalNote3 of the ESA Planetary study
+
+Venus.scat_data__*.xml
+-----------------------
+- single scattering data for different cloud/haze layers and modes
+- data created by J. Mendrok (LTU) within ESA Planetary study
+- for more details see TechnicalNote3 of the ESA Planetary study
+
+NOTE: single scattering data and number density fields form paired groups, which
+ are linked by cloud category (H2SO4) and bulk type (layer and mode, *-bulk).
+ within the groups, one can choose different altitude distributions (*-profile)
+ for the number density fields.
+See Consolidated Design Document of the ESA Planetary study for details on the
+ relation of single scattering and number density data and on the file name
+ layout.
diff --git a/scattering/README b/scattering/README
new file mode 100644
index 0000000000000000000000000000000000000000..b7aa787a1570032b655558767159881f47784e7b
--- /dev/null
+++ b/scattering/README
@@ -0,0 +1,26 @@
+This directory data related to running scattering calculations. Major part is
+single scattering data for different types of (well-defined) scattering particles.
+
+H2O_liquid/*.xml
+-----------------------
+- single scattering data (*.um.xml) and corresponding meta data (*um.meta.xml)
+- liquid water particles (e.g. for Earth liquid clouds and rain)
+- range of sizes (0.1-10,000um), all assumed as spheres
+- data created by ARTS developers using atmlab routines (Maetzler's matlab Mie code; dielectric property routines)
+- for more details data headers
+
+H2O_ice/*.xml
+-----------------------
+- single scattering data (*.um.xml) and corresponding meta data (*um.meta.xml)
+- water ice particles (e.g. for Earth ice clouds, hail, snow)
+- range of sizes (0.1-10,000um), all assumed as solid spheres
+- data created by ARTS developers using atmlab routines (Maetzler's matlab Mie code; dielectric property routines)
+- for more details data headers
+
+fosangles_360.xml
+-----------------------
+- set of directions/angles (polar and azimuth angles) for FOS calculations
+  (radiation path directions)
+- directions are equally distributed over the sphere, each representing a solid
+  angle of 4Pi/360 sr
+- data created by P. Eriksson (Chalmers)
diff --git a/spectroscopy/Perrin/README b/spectroscopy/Perrin/README
new file mode 100644
index 0000000000000000000000000000000000000000..6a2304620af03aa6bfb6e2f14166b164bd4d6d83
--- /dev/null
+++ b/spectroscopy/Perrin/README
@@ -0,0 +1,181 @@
+This directory contains a spectroscopic line catalogue.
+
+NOTE: currently Hitran-source data is not up-to-date. (to be fixed by Oliver/Richard)
+
+- prepared as part of ESA ESA Planetary Toolbox study. For more information see
+  the ESA study's Technical Note 3.
+- specifically prepared for planetary radiative transfer
+- covers data for frequencies <3THz
+- data is of unified ARTSCAT-5 format
+
+
+Species overview
+================
+
+Species  #    Source
+C2H2    (26)  Hitran
+C2H4    (38)  Hitran  NOL* (701.202696)
+C2H6    (27)  Hitran  NOL* (706.601510)
+C3H8          Perrin  [NOH*]
+C4H2    (43)  Hitran
+CF4     (42)  Hitran  NOL* (594.580718)
+CH3Br   (40)  Hitran  NOL* (794.403140)
+CH3CN   (41)  Hitran  NOL* (890.051655)
+CH3Cl   (24)  Hitran
+CH3OH   (39)  Hitran
+CH4     (6)   Perrin
+CO      (5)   Perrin
+CO2     (2)   Perrin
+COF2    (29)  Hitran  NOL* (686.730618)
+CS      (46)  Hitran
+ClO     (18)  Hitran
+ClONO2  (35)  Hitran  NOL* (763.641040)
+H2      (45)  Hitran
+H2CO    (20)  Perrin
+H2O     (1)   Perrin
+H2O2    (25)  Perrin
+H2S     (31)  Perrin
+H2SO4         Perrin
+HBr     (16)  Hitran
+HCN     (23)  Hitran
+HC3N    (44)  Hitran
+HCOOH   (32)  Hitran
+HCl     (15)  Perrin
+HF      (14)  Perrin
+HI      (17)  Hitran
+HNO3    (12)  Hitran
+HO2     (33)  Perrin
+HOBr    (37)  Hitran
+HOCl    (21)  Hitran
+N2      (22)  Hitran
+N2O     (4)   Hitran
+NH3     (11)  Perrin
+NO      (8)   Hitran
+NO+     (36)  Hitran  NOL* (1634.831153)
+NO2     (10)  Hitran
+O       (34)  Hitran
+O2      (7)   Perrin
+O3      (3)   Perrin
+OCS     (19)  Perrin
+OH      (13)  Hitran
+PH3     (28)  Perrin
+SF6     (30)  Hitran  NOL* (580.000244)
+SO            Perrin
+SO2     (9)   Perrin
+SO3     (47)  Hitran
+
+NOL*:    No lines between 0-3THz (1st linepos in HITRAN [cm-1])
+NOH*:    No lines in HITRAN yet at all
+
+Perrin' spectroscopic line database
+==================================
+
+Latest version:
+
+Nov 23  2012 C3H8.xml.gz
+Mar 15  2012 CH4.xml.gz
+Mar 17  2014 CO.xml.gz
+Jan 29  2014 CO2.xml.gz
+Mar  1  2012 H2CO.xml.gz
+Jan 29  2014 H2O.xml.gz
+Mar 15  2012 H2O2.xml.gz
+Mar  1  2014 H2S.xml.gz
+Mar 15  2012 H2SO4.xml.gz
+Mar 17  2014 HCl.xml.gz
+Mar  1  2014 HF.xml.gz
+Aug 23  2012 HO2.xml.gz
+Mar 15  2012 NH3.xml.gz
+Feb  6  2014 O2.xml.gz
+Feb  6  2014 O3.xml.gz
+Mar  1  2014 OCS.xml.gz
+Mar 15  2012 PH3.xml.gz
+Apr  7  2014 SO.xml.gz
+Feb  6  2014 SO2.xml.gz
+
+
+Unit conversion values used:
+
+           ccc=29979.2458d+14
+           Joule=5.03411701D+22
+c          E"(ARTS)=E"(HITRAN)/Joule
+           HzPa=0.33798382D-05
+c          Gamma(ARTS)=Gamma(HITRAN)/HzPa
+           ZIarts=2.99792458D+6
+c          Int(ARTS)=Int(HITRAN)*ZIarts
+           sarts=2.99792458D+10
+c          sigm(ARTS)=sigm(HITRAN)*sarts
+
+
+
+Species from Hitran
+===================
+
+Latest version: 2012 edition
+
+2015-06-09 17:05 C2H2.xml.gz
+2015-06-09 17:06 C4H2.xml.gz
+2015-06-09 17:05 CH3Cl.xml.gz
+2013-01-11 09:07 CH3OH.xml.gz
+2015-06-09 17:05 ClO.xml.gz
+2015-06-09 17:06 CS.xml.gz
+2015-06-09 17:06 H2.xml.gz
+2015-06-09 17:05 HBr.xml.gz
+2015-06-09 17:06 HC3N.xml.gz
+2012-03-19 11:03 HCN.xml.gz
+2015-06-09 17:05 HCOOH.xml.gz
+2015-06-09 17:05 HI.xml.gz
+2015-06-09 17:05 HNO3.xml.gz
+2015-06-09 17:05 HOBr.xml.gz
+2015-06-09 17:05 HOCl.xml.gz
+2012-03-19 11:03 N2O.xml.gz
+2015-06-09 17:05 N2.xml.gz
+2015-06-09 17:05 NO2.xml.gz
+2015-06-09 17:05 NO.xml.gz
+2015-06-09 17:05 OH.xml.gz
+2012-03-19 11:03 O.xml.gz
+2015-06-09 17:06 SO3.xml.gz
+
+
+Empty files for species with no (THz) lines
+===========================================
+(but required as broadening species (*) or due to existence of Earth profile data)
+
+2012-03-19 11:03 C2H6.xml.gz
+2012-03-19 11:03 COF2.xml.gz
+2012-11-24 02:04 He.xml.gz
+2012-03-19 11:03 SF6.xml.gz
+
+
+Line Count
+==========
+
+- abs_lines_per_speciesCreateFromLines
+  0: N2O-*-*-*: 451 lines
+  1: NO-*-*-*: 5233 lines
+  2: NO2-*-*-*: 20170 lines
+  3: HNO3-*-*-*: 490086 lines
+  4: OH-*-*-*: 2111 lines
+  5: HBr-*-*-*: 326 lines
+  6: HI-*-*-*: 375 lines
+  7: ClO-*-*-*: 9453 lines
+  8: HOCl-*-*-*: 2952 lines
+  9: N2-*-*-*: 36 lines
+  10: HCN-*-*-*: 319 lines
+  11: CH3Cl-*-*-*: 12824 lines
+  12: C2H2-*-*-*: 40 lines
+  13: HCOOH-*-*-*: 6808 lines
+  14: O-*-*-*: 1 lines
+  15: HOBr-*-*-*: 1463 lines
+  16: CH3OH-*-*-*: 4663 lines
+  17: C4H2-*-*-*: 3744 lines
+  18: HC3N-*-*-*: 985 lines
+  19: H2-*-*-*: 34 lines
+  20: CS-*-*-*: 694 lines
+  21: SO3-*-*-*: 25 lines
+
+
+
+ARTS controlfile used to extract species from HITRAN data
+=========================================================
+see ExtractFromHITRAN.arts (run with -r 030 to create above line count)
+
diff --git a/spectroscopy/Perrin_artscat34/README b/spectroscopy/Perrin_artscat34/README
index cf493a307ecb08aeb565c590042623f4471b46f6..43bb2439df85944021fa77eff978fa8fdf31163f 100644
--- a/spectroscopy/Perrin_artscat34/README
+++ b/spectroscopy/Perrin_artscat34/README
@@ -1,3 +1,12 @@
+This directory contains a spectroscopic line catalogue.
+
+- prepared as part of ESA ESA Planetary Toolbox study. For more information see
+  the ESA study's Technical Note 3.
+- specifically prepared for planetary radiative transfer
+- covers data for frequencies <3THz
+- data is of ARTSCAT-4 (source: Perrin) and ARTSCAT-3 (source: Hitran) format
+
+
 Species overview
 ================