examples/helix_example.cpp → examples/framework_examples/helix_trajectory.cpp

 /*
  * (c) Copyright 2018 CORSIKA Project, corsika-project@lists.kit.edu
  *
- * This software is distributed under the terms of the GNU General Public
- * Licence version 3 (GPL Version 3). See file LICENSE for a full version of
- * the license.
+ * This software is distributed under the terms of the 3-clause BSD license.
+ * See file LICENSE for a full version of the license.
  */
 
 #include <corsika/framework/geometry/Helix.hpp>
@@ -20,7 +19,7 @@ using namespace corsika;
 
 int main() {
 
-  logging::set_level(logging::level::info);
+  logging::set_level(logging::level::warn);
 
   CORSIKA_LOG_INFO("helix_example");
 

examples/particle_list_example.cpp → examples/framework_examples/known_particles.cpp

 /*
  * (c) Copyright 2018 CORSIKA Project, corsika-project@lists.kit.edu
  *
- * This software is distributed under the terms of the GNU General Public
- * Licence version 3 (GPL Version 3). See file LICENSE for a full version of
- * the license.
+ * This software is distributed under the terms of the 3-clause BSD license.
+ * See file LICENSE for a full version of the license.
  */
 
 #include <corsika/framework/core/ParticleProperties.hpp>
 #include <corsika/modules/QGSJetII.hpp>
 #include <corsika/modules/Sibyll.hpp>
-#include <corsika/setup/SetupEnvironment.hpp>
 #include <corsika/framework/core/PhysicalUnits.hpp>
 
-/*
-  NOTE, WARNING, ATTENTION
-
-  The file Random.hpp implements the hooks of external modules to the C8 random
-  number generator. It has to occur excatly ONCE per linked
-  executable. If you include the header below multiple times and
-  link this togehter, it will fail.
- */
-#include <corsika/modules/Random.hpp>
-
 #include <iomanip>
 #include <string>
 
@@ -29,8 +17,11 @@ using namespace corsika;
 using namespace std;
 
 //
-// The example main program for a particle list
+// This example prints out all of the particles that are
+// known to CORSIKA 8 and the corresponding IDs in the
+// hadronic model codes.
 //
+
 int main() {
 
   logging::set_level(logging::level::info);
@@ -41,24 +32,25 @@ int main() {
       "------------------------------------------\n"
       "        particles in CORSIKA\n"
       "------------------------------------------\n");
-  int const width = 20 + 10 + 10 + 10 + 15 + 15 + 17;
+  int const width = 25 + 10 + 10 + 10 + 10 + 16 + 16 + 17;
   logging::info(
-      "Name                 | "
+      "Name                      | "
+      "C8 code    | "
       "PDG-id     | "
       "SIBYLL-id  | "
       "QGSJETII-id| "
       "PDG-mass (GeV)   | "
       "SIBYLL-mass (GeV)|");
   logging::info("{:->{}}", ' ', width);
-  for (auto p : get_all_particles()) {
+  for (auto const p : get_all_particles()) {
     if (!is_nucleus(p)) {
       corsika::sibyll::SibyllCode sib_id = corsika::sibyll::convertToSibyll(p);
       auto const sib_mass = (sib_id != corsika::sibyll::SibyllCode::Unknown
                                  ? to_string(corsika::sibyll::getSibyllMass(p) / 1_GeV)
                                  : "");
       auto const qgs_id = corsika::qgsjetII::convertToQgsjetII(p);
-      logging::info("{:20} | {:10} | {:10} | {:10} | {:>15.5} | {:>15.5} |", p,
-                    static_cast<int>(get_PDG(p)),
+      logging::info("{:25} | {:10} | {:10} | {:10} | {:10} | {:>16.5} | {:>16.5} |",
+                    get_name(p), p, static_cast<int>(get_PDG(p)),
                     (sib_id != corsika::sibyll::SibyllCode::Unknown
                          ? to_string(static_cast<int>(sib_id))
                          : ""),

examples/stack_example.cpp → examples/framework_examples/stack.cpp

 /*
  * (c) Copyright 2018 CORSIKA Project, corsika-project@lists.kit.edu
  *
- * This software is distributed under the terms of the GNU General Public
- * Licence version 3 (GPL Version 3). See file LICENSE for a full version of
- * the license.
+ * This software is distributed under the terms of the 3-clause BSD license.
+ * See file LICENSE for a full version of the license.
  */
 
 #include <corsika/framework/core/ParticleProperties.hpp>
@@ -43,7 +42,7 @@ void read(VectorStack& s) {
 
 int main() {
 
-  logging::set_level(logging::level::info);
+  logging::set_level(logging::level::warn);
 
   CORSIKA_LOG_INFO("stack_example");
   VectorStack s;

examples/staticsequence_example.cpp → examples/framework_examples/static_sequence.cpp

 /*
  * (c) Copyright 2018 CORSIKA Project, corsika-project@lists.kit.edu
  *
- * This software is distributed under the terms of the GNU General Public
- * Licence version 3 (GPL Version 3). See file LICENSE for a full version of
- * the license.
+ * This software is distributed under the terms of the 3-clause BSD license.
+ * See file LICENSE for a full version of the license.
  */
 
 #include <array>
@@ -11,6 +10,7 @@
 #include <iostream>
 
 #include <corsika/framework/process/ProcessSequence.hpp>
+#include <corsika/framework/core/Step.hpp>
 #include <corsika/framework/geometry/Point.hpp>
 #include <corsika/framework/geometry/RootCoordinateSystem.hpp>
 #include <corsika/framework/geometry/Vector.hpp>
@@ -18,14 +18,19 @@
 using namespace corsika;
 using namespace std;
 
-const int nData = 10;
+const int nSteps = 10;
 
 class Process1 : public ContinuousProcess<Process1> {
 public:
   Process1() {}
-  template <typename D, typename T>
-  ProcessReturn doContinuous(D& d, T&, bool const) const {
-    for (int i = 0; i < nData; ++i) d.p[i] += 1;
+  template <typename D>
+  ProcessReturn doContinuous(Step<D>& d, bool const) const {
+    LengthVector displacement_{get_root_CoordinateSystem(), 1_m, 0_m, 0_m};
+    DirectionVector dU_{get_root_CoordinateSystem(), {1, 0, 0}};
+    for (int i = 0; i < nSteps; ++i) {
+      d.add_displacement(displacement_);
+      d.add_dU(dU_);
+    }
     return ProcessReturn::Ok;
   }
 };
@@ -34,9 +39,10 @@ class Process2 : public ContinuousProcess<Process2> {
 public:
   Process2() {}
 
-  template <typename D, typename T>
-  inline ProcessReturn doContinuous(D& d, T&, bool const) const {
-    for (int i = 0; i < nData; ++i) d.p[i] -= 0.1 * i;
+  template <typename D>
+  inline ProcessReturn doContinuous(Step<D>& d, bool const) const {
+    LengthVector displacement_{get_root_CoordinateSystem(), 0.1_m, 0_m, 0_m};
+    for (int i = 0; i < nSteps; ++i) { d.add_displacement(-displacement_); }
     return ProcessReturn::Ok;
   }
 };
@@ -45,8 +51,8 @@ class Process3 : public ContinuousProcess<Process3> {
 public:
   Process3() {}
 
-  template <typename D, typename T>
-  inline ProcessReturn doContinuous(D&, T&, bool const) const {
+  template <typename D>
+  inline ProcessReturn doContinuous(Step<D>&, bool const) const {
     return ProcessReturn::Ok;
   }
 };
@@ -55,9 +61,9 @@ class Process4 : public ContinuousProcess<Process4> {
 public:
   Process4(const double v)
       : fV(v) {}
-  template <typename D, typename T>
-  inline ProcessReturn doContinuous(D& d, T&, bool const) const {
-    for (int i = 0; i < nData; ++i) d.p[i] *= fV;
+  template <typename D>
+  inline ProcessReturn doContinuous(Step<D>& d, bool const) const {
+    for (int i = 0; i < nSteps; ++i) { d.add_dEkin(i * fV * 1_eV); }
     return ProcessReturn::Ok;
   }
 
@@ -66,38 +72,52 @@ private:
 };
 
 struct DummyData {
-  double p[nData] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
+  Point getPosition() const { return Point(get_root_CoordinateSystem(), 0_m, 0_m, 0_m); }
+  DirectionVector getDirection() const {
+    return DirectionVector{get_root_CoordinateSystem(), {0, 0, 0}};
+  }
 };
 struct DummyStack {
   void clear() {}
 };
-struct DummyTrajectory {};
+struct DummyTrajectory {
+  TimeType getDuration(int u) const { return 0_s; }
+  Point getPosition(int u) const {
+    return Point(get_root_CoordinateSystem(), 0_m, 0_m, 0_m);
+  }
+  DirectionVector getDirection(int u) const {
+    return DirectionVector{get_root_CoordinateSystem(), {0, 0, 0}};
+  }
+};
 
 void modular() {
 
   //              = 0
-  Process1 m1;      // + 1.0
-  Process2 m2;      // - (0.1*i)
+  Process1 m1;      // + 1.0m
+  Process2 m2;      // - 0.1m
   Process3 m3;      // * 1.0
-  Process4 m4(1.5); // * 1.5
+  Process4 m4(1.5); // * i * 1.5_eV
 
   auto sequence = make_sequence(m1, m2, m3, m4);
 
   DummyData particle;
   DummyTrajectory track;
-
-  double check[nData] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
-
-  const int nEv = 10;
-  for (int iEv = 0; iEv < nEv; ++iEv) {
-    sequence.doContinuous(particle, track, ContinuousProcessIndex(0));
-    for (int i = 0; i < nData; ++i) {
-      check[i] += 1. - 0.1 * i;
-      check[i] *= 1.5;
-    }
+  Step step(particle, track);
+
+  sequence.doContinuous(step, ContinuousProcessIndex(0));
+  double X = 0;
+  double energy = 0;
+  double direction = 0;
+  for (int i = 0; i < nSteps; ++i) {
+    X += 1. - 0.1;
+    energy += i * 1.5;
+    direction += 1.;
   }
 
-  for (int i = 0; i < nData; ++i) { assert(particle.p[i] == check[i]); }
+  assert(static_cast<int>(step.getDisplacement().getX(get_root_CoordinateSystem()) /
+                          1_m) == static_cast<int>(X));
+  assert((step.getDiffEkin() / 1_eV) == energy);
+  assert((step.getDiffDirection().getX(get_root_CoordinateSystem())) == direction);
 
   cout << " done (checking...) " << endl;
 }
@@ -105,7 +125,6 @@ void modular() {
 int main() {
 
   logging::set_level(logging::level::info);
-  corsika_logger->set_pattern("[%n:%^%-8l%$] custom pattern: %v");
 
   std::cout << "staticsequence_example" << std::endl;
 

examples/physics_examples/cross_section.cpp

+/*
+ * (c) Copyright 2019 CORSIKA Project, corsika-project@lists.kit.edu
+ *
+ * This software is distributed under the terms of the 3-clause BSD license.
+ * See file LICENSE for a full version of the license.
+ */
+
+#include <corsika/modules/Epos.hpp>
+#include <corsika/modules/Sibyll.hpp>
+#include <corsika/modules/QGSJetII.hpp>
+#include <corsika/modules/Pythia8.hpp>
+
+#include <corsika/framework/core/ParticleProperties.hpp>
+#include <corsika/framework/core/PhysicalUnits.hpp>
+
+#include <corsika/framework/geometry/RootCoordinateSystem.hpp>
+#include <corsika/framework/geometry/Vector.hpp>
+
+#include <corsika/framework/random/RNGManager.hpp>
+
+#include <corsika/setup/SetupC7trackedParticles.hpp>
+#include <corsika/modules/Random.hpp>
+
+#include <fstream>
+#include <string>
+#include <tuple>
+
+using namespace corsika;
+
+/**
+ * Calculates the inelastic p-p cross section and the production cross section for
+ * p-Oxygen for a given interaction model using the C8 interface getCrossSection(ID1, ID2,
+ * P41, P42) where ID? and P4? are the particle Id and 4-momenta of projectile and target
+ * respectively. The input to getCrossSection can be ANY frame of reference. Internally
+ * the boost to the CM is calculated and the correct cross section is returned.
+ * calculate_cross_sections allows to switch between the CM and lab configurations.
+ *
+ * output is a table in ACSCII file cross-sections-<model-name>.txt
+ *
+ * Energy ranges from 100GeV to 10^12 GeV (10^11 eV to 10^21 eV) in the lab. frame
+ * table format is: "# i, E_lab (GeV), E_cm per nucleon (GeV), cross section p-p (mb),
+ * production "
+ *
+ * @param model the interaction model to use
+ * @param model_name string with model name
+ *
+ * @return a tuple of: inelastic cross section, elastic cross section
+ */
+
+template <typename TModel>
+void calculate_cross_sections(TModel& model, std::string const& model_name) {
+
+  std::stringstream fname;
+  fname << "cross-sections-" << model_name << ".txt";
+  std::ofstream out(fname.str());
+  out << "# cross section table for " << model_name << "\n";
+  out << "# i, P_lab (GeV), E_cm per nucleon (GeV), cross section p-p (mb), cross "
+         "section pi-p (mb), production "
+         "cross section p-O16 (mb), production cross section p-N14 (mb), production "
+         "cross section p-Ar40 (mb), cross section pi-O16 (mb), production cross "
+         "section, pi-N14 (mb), production, cross section pi-Ar40 (mb), cross section "
+         "He-O16 (mb), production cross section, He-N14 (mb), production, cross section "
+         "He-Ar40 (mb)\n";
+
+  CoordinateSystemPtr const& cs = get_root_CoordinateSystem();
+
+  float const amin = 2;
+  float const amax = 11;
+  int const nebins = 15;
+  float const da = (amax - amin) / (float)nebins;
+
+  for (int i = 0; i < nebins; ++i) {
+
+    corsika::units::si::HEPMomentumType const setP = pow(10, da * i + amin) * 1_GeV;
+    CrossSectionType xs_prod_hNuc[3][3] = {};
+    CrossSectionType xs_prod_hp[3] = {};
+    HEPEnergyType setE, comEnn;
+    int l = -1;
+    for (auto projId : {Code::Proton, Code::PiPlus, Code::Helium}) {
+      ++l;
+      setE = calculate_total_energy(setP, get_mass(projId));
+      comEnn = corsika::calculate_com_energy(setE, get_mass(projId),
+                                             corsika::constants::nucleonMass);
+
+      // four momenta in lab frame
+      corsika::FourMomentum p4Proj(setE, MomentumVector(cs, {0_eV, 0_eV, setP}));
+      corsika::FourMomentum p4protonTarg(Proton::mass,
+                                         MomentumVector(cs, {0_eV, 0_eV, 0_eV}));
+
+      // had-p
+      auto const [xs_prod, xs_ela] =
+          model->getCrossSectionInelEla(projId, Code::Proton, p4Proj, p4protonTarg);
+      xs_prod_hp[l] = xs_prod;
+
+      int k = -1;
+      for (auto targNuc : {Code::Oxygen, Code::Nitrogen, Code::Argon}) {
+        ++k;
+        FourMomentum const p4nucTarg = corsika::FourMomentum(
+            get_mass(targNuc), MomentumVector(cs, {0_eV, 0_eV, 0_eV}));
+        xs_prod_hNuc[l][k] = model->getCrossSection(projId, targNuc, p4Proj, p4nucTarg);
+      }
+    }
+    CORSIKA_LOG_INFO(
+        "Elab={:15.2f} GeV,Ecom={:15.2f} GeV, sig-p-p={:6.2f} mb, sig-pi-p={:6.2f} mb, "
+        "p-O={:6.2f} mb, p-N={:6.2f} mb, p-Ar={:6.2f} mb "
+        "pi-O={:6.2f} mb, pi-N={:6.2f} mb, pi-Ar={:6.2f} mb "
+        "He-O={:6.2f} mb, He-N={:6.2f} mb, He-Ar={:6.2f} mb",
+        setP / 1_GeV, comEnn / 1_GeV, xs_prod_hp[0] / 1_mb, xs_prod_hp[1] / 1_mb,
+        xs_prod_hNuc[0][0] / 1_mb, xs_prod_hNuc[0][1] / 1_mb, xs_prod_hNuc[0][2] / 1_mb,
+        xs_prod_hNuc[1][0] / 1_mb, xs_prod_hNuc[1][1] / 1_mb, xs_prod_hNuc[1][2] / 1_mb,
+        xs_prod_hNuc[2][0] / 1_mb, xs_prod_hNuc[2][1] / 1_mb, xs_prod_hNuc[2][2] / 1_mb);
+
+    out << i << " " << setP / 1_GeV << " " << comEnn / 1_GeV << " "
+        << xs_prod_hp[0] / 1_mb << " " << xs_prod_hp[1] / 1_mb << " "
+        << xs_prod_hNuc[0][0] / 1_mb << " " << xs_prod_hNuc[0][1] / 1_mb << " "
+        << xs_prod_hNuc[0][2] / 1_mb << " " << xs_prod_hNuc[1][0] / 1_mb << " "
+        << xs_prod_hNuc[1][1] / 1_mb << " " << xs_prod_hNuc[1][2] / 1_mb << " "
+        << " " << xs_prod_hNuc[2][0] / 1_mb << " " << xs_prod_hNuc[2][1] / 1_mb << " "
+        << xs_prod_hNuc[2][2] / 1_mb << "\n";
+  }
+  out.close();
+  std::cout << "wrote cross section table for " << model_name
+            << " in file: " << fname.str() << std::endl;
+}
+
+int main(int argc, char** argv) {
+
+  logging::set_level(logging::level::info);
+
+  if (argc != 2) {
+    std::cout << "usage: check <interaction model> \n valid models are: sibyll, "
+                 "epos, qgsjet, pythia8"
+              << std::endl;
+    return 1;
+  }
+  std::string int_model_name = std::string(argv[1]);
+
+  if (int_model_name == "sibyll") {
+    RNGManager<>::getInstance().registerRandomStream("sibyll");
+    auto model = std::make_shared<corsika::sibyll::InteractionModel>(
+        std::set<Code>{Code::Proton, Code::Oxygen, Code::Nitrogen},
+        corsika::setup::C7trackedParticles);
+    calculate_cross_sections(model, int_model_name);
+  } else if (int_model_name == "pythia8") {
+    RNGManager<>::getInstance().registerRandomStream("pythia");
+    auto model = std::make_shared<corsika::pythia8::InteractionModel>();
+    calculate_cross_sections(model, int_model_name);
+
+  } else if (int_model_name == "epos") {
+    RNGManager<>::getInstance().registerRandomStream("epos");
+    auto model = std::make_shared<corsika::epos::InteractionModel>(
+        corsika::setup::C7trackedParticles);
+    calculate_cross_sections(model, int_model_name);
+  } else if (int_model_name == "qgsjet") {
+    RNGManager<>::getInstance().registerRandomStream("qgsjet");
+    auto model = std::make_shared<corsika::qgsjetII::InteractionModel>();
+    calculate_cross_sections(model, int_model_name);
+  } else {
+    std::cout << "interaction model should be: sibyll, epos, qgsjet or pythia"
+              << std::endl;
+    return 1;
+  }
+}

examples/physics_examples/had_interactions.cpp

+/*
+ * (c) Copyright 2019 CORSIKA Project, corsika-project@lists.kit.edu
+ *
+ * This software is distributed under the terms of the 3-clause BSD license.
+ * See file LICENSE for a full version of the license.
+ */
+
+#include <corsika/modules/Epos.hpp>
+#include <corsika/modules/QGSJetII.hpp>
+#include <corsika/modules/Sibyll.hpp>
+#include <corsika/modules/Pythia8.hpp>
+
+#include <corsika/framework/core/ParticleProperties.hpp>
+#include <corsika/framework/core/PhysicalUnits.hpp>
+
+#include <corsika/framework/geometry/Point.hpp>
+#include <corsika/framework/geometry/RootCoordinateSystem.hpp>
+#include <corsika/framework/geometry/Vector.hpp>
+
+#include <corsika/framework/random/RNGManager.hpp>
+
+#include <corsika/framework/core/EnergyMomentumOperations.hpp>
+
+#include <corsika/media/Environment.hpp>
+#include <corsika/media/HomogeneousMedium.hpp>
+#include <corsika/media/MediumPropertyModel.hpp>
+#include <corsika/media/NuclearComposition.hpp>
+#include <corsika/media/ShowerAxis.hpp>
+#include <corsika/media/UniformMagneticField.hpp>
+
+#include <corsika/setup/SetupStack.hpp>
+#include <corsika/setup/SetupC7trackedParticles.hpp>
+
+#include <corsika/modules/Random.hpp>
+
+#include <fstream>
+#include <iostream>
+#include <tuple>
+
+using namespace corsika;
+
+using EnvironmentInterface = IMediumPropertyModel<IMagneticFieldModel<IMediumModel>>;
+using EnvType = Environment<EnvironmentInterface>;
+
+template <typename TModel>
+void create_events(TModel& model, std::string const& model_name, Code const projectileId,
+                   FourMomentum projectileP4, Code const targetId, FourMomentum targetP4,
+                   int const nEvents) {
+
+  logging::set_level(logging::level::info);
+
+  // calculate Ecm per nucleon (sqrtSNN). Used only for output!
+  auto const projectileP4NN =
+      projectileP4 / (is_nucleus(projectileId) ? get_nucleus_A(projectileId) : 1);
+  auto const targetP4NN = targetP4 / (is_nucleus(targetId) ? get_nucleus_A(targetId) : 1);
+  auto const SNN = (projectileP4NN + targetP4NN).getNormSqr();
+  HEPEnergyType const sqrtSNN = sqrt(SNN);
+  auto const sqrtS = (projectileP4 + targetP4).getNorm();
+  CORSIKA_LOG_INFO("{} + {} interactions at sqrtSNN= {} GeV, sqrtS = {} GeV",
+                   projectileId, targetId, sqrtSNN / 1_GeV, sqrtS / 1_GeV);
+
+  // target material and environment (not used just there to create the C8 stack)
+  EnvType env;
+  auto& universe = *(env.getUniverse());
+  CoordinateSystemPtr const& rootCS = env.getCoordinateSystem();
+  auto world = EnvType::createNode<Sphere>(Point{rootCS, 0_m, 0_m, 0_m}, 150_km);
+  using MyHomogeneousModel =
+      MediumPropertyModel<UniformMagneticField<HomogeneousMedium<EnvironmentInterface>>>;
+  auto const props = world->setModelProperties<MyHomogeneousModel>(
+      Medium::AirDry1Atm, MagneticFieldVector(rootCS, 0_T, 0_T, 0_T),
+      1_kg / (1_m * 1_m * 1_m), NuclearComposition({targetId}, {1.}));
+  world->setModelProperties(props);
+  universe.addChild(std::move(world));
+
+  // projectile (dummy)
+  auto const plab3 = projectileP4.getSpaceLikeComponents();
+  auto p0 = Point(rootCS, 0_m, 0_m, 0_m);
+  setup::Stack<EnvType> stack;
+  stack.addParticle(std::make_tuple(
+      projectileId, calculate_kinetic_energy(plab3.getNorm(), get_mass(projectileId)),
+      plab3.normalized(), p0, 0_ns));
+  auto particle = stack.first();
+  particle.setNode(universe.getContainingNode(p0));
+
+  std::stringstream pname;
+  pname << "particles-" << model_name << "-" << projectileId << "-" << targetId << "-"
+        << sqrtSNN / 1_GeV << "GeV"
+        << ".txt";
+
+  unsigned int count_central_charged = 0;
+  HEPMomentumType total_pt = 0_GeV;
+
+  std::ofstream pout(pname.str());
+  // add header
+  pout << "# particle production in " << model_name << " for " << projectileId << " + "
+       << targetId << " interactions."
+       << "\n";
+  pout << "# lab. momentum of projectile: "
+       << projectileP4.getSpaceLikeComponents().getNorm() / 1_GeV << " (GeV)"
+       << "\n";
+  pout << "# CM energy per nucleon: " << sqrtSNN / 1_GeV << " (GeV)"
+       << "\n";
+  pout << "# i, j, particle name, PDG id, p.rap, rap., energy (GeV), px, py, pz (GeV), "
+          "pt (GeV), charge"
+       << "\n";
+  for (int i = 0; i < nEvents; ++i) {
+
+    // empty stack from previous interaction
+    stack.clear();
+    // add particle to get StackView to write secondaries to C8 stack
+    stack.addParticle(std::make_tuple(
+        projectileId, calculate_kinetic_energy(plab3.getNorm(), get_mass(projectileId)),
+        plab3.normalized(), p0, 0_ns)); // irrelevant
+    auto particle = stack.first();
+    particle.setNode(universe.getContainingNode(p0));
+    setup::Stack<EnvType>::stack_view_type output(particle);
+
+    // generate secondaries and fill output
+    model->doInteraction(output, projectileId, targetId, projectileP4, targetP4);
+
+    // loop through secondaries and calculate higher level variables (rapidity, pt, ...),
+    // write to file
+    int j = -1;
+    HEPMomentumType tpt = 0_GeV;
+    for (auto& secondary : output) {
+      ++j;
+      // pseudorapidity, rapidity
+      auto const p = secondary.getMomentum();
+      auto const pz = p.getZ(rootCS);
+      auto const px = p.getX(rootCS);
+      auto const py = p.getY(rootCS);
+      auto const pabs = p.getNorm();
+      auto const pt = sqrt(p.getSquaredNorm() - square(pz));
+      auto const en = secondary.getEnergy();
+      auto const mt = sqrt(square(pt) + square(get_mass(secondary.getPID())));
+      double prap, rap;
+      if (pz / 1_GeV <= 0) {
+        rap = log(mt / (en - pz));
+        prap = log((pt + 1.0_eV) / (pabs - pz));
+      } else {
+        rap = log((en + pz) / mt);
+        prap = log((pabs + pz) / (pt + 1.0_eV));
+      }
+      pout << i << " " << j << " " << secondary.getPID() << " "
+           << static_cast<int>(get_PDG(secondary.getPID())) << " " << prap << " " << rap
+           << " " << en / 1_GeV << " " << px / 1_GeV << " " << py / 1_GeV << " "
+           << pz / 1_GeV << " " << pt / 1_GeV << " "
+           << get_charge_number(secondary.getPID()) << "\n";
+      // calculate plateau (CMS experiment)
+      if (abs(prap) < 2.5 && get_charge_number(secondary.getPID()) != 0) {
+        count_central_charged++;
+      }
+      tpt += pt;
+    }
+    total_pt += tpt / float(j);
+  }
+  std::cout << "average plateau height: " << count_central_charged / float(nEvents)
+            << std::endl;
+  std::cout << "average pt (GeV): " << total_pt / float(nEvents) / 1_GeV << std::endl;
+  std::cout << "wrote hadronic events for " << model_name << " in file: " << pname.str()
+            << std::endl;
+};
+
+int main(int argc, char** argv) {
+
+  std::string int_model, projectile, target;
+  HEPMomentumType P0;
+  int Nevents = 10;
+  if (argc < 2 || argc > 7) {
+    std::cout << "usage: check <interaction model> \n valid models are: sibyll, "
+                 "epos, qgsjet, pythia8. Other options are (in that order): <projectile> "
+                 "<target> <projectile momentum (lab in GeV)> <no. of events>. Defaults "
+                 "are: proton, proton, 100, 10"
+              << std::endl;
+    return 1;
+  } else if (argc == 2) {
+    int_model = std::string(argv[1]);
+    projectile = "proton";
+    target = "proton";
+    P0 = 100_GeV;
+  } else if (argc == 3) {
+    int_model = std::string(argv[1]);
+    projectile = std::string(argv[2]);
+    target = "proton";
+    P0 = 100_GeV;
+  } else if (argc == 4) {
+    int_model = std::string(argv[1]);
+    projectile = std::string(argv[2]);
+    target = std::string(argv[3]);
+    P0 = 100_GeV;
+  } else if (argc == 5) {
+    int_model = std::string(argv[1]);
+    projectile = std::string(argv[2]);
+    target = std::string(argv[3]);
+    P0 = std::stoi(std::string(argv[4])) * 1_GeV;
+  } else if (argc == 6) {
+    int_model = std::string(argv[1]);
+    projectile = std::string(argv[2]);
+    target = std::string(argv[3]);
+    P0 = std::stoi(std::string(argv[4])) * 1_GeV;
+    Nevents = std::stoi(std::string(argv[5]));
+  }
+
+  Code projectileId;
+  if (projectile == "proton")
+    projectileId = Code::Proton;
+  else if (projectile == "antiproton")
+    projectileId = Code::AntiProton;
+  else if (projectile == "pion")
+    projectileId = Code::PiPlus;
+  else if (projectile == "oxygen")
+    projectileId = Code::Oxygen;
+  else {
+    std::cout << "unknown projectile. pick proton, antiproton, pion or oxygen"
+              << std::endl;
+    return 0;
+  }
+  Code targetId;
+  if (target == "proton")
+    targetId = Code::Proton;
+  else if (target == "nitrogen")
+    targetId = Code::Nitrogen;
+  else {
+    std::cout << "unknown target. pick proton or nitrogen" << std::endl;
+    return 0;
+  }
+
+  auto const rootCS = get_root_CoordinateSystem();
+  FourMomentum const P4proj{
+      calculate_total_energy(get_mass(projectileId), P0),
+      {rootCS, {HEPMomentumType::zero(), HEPMomentumType::zero(), P0}}};
+
+  FourMomentum const P4targ{
+      calculate_total_energy(get_mass(targetId), HEPMomentumType::zero()),
+      {rootCS,
+       {HEPMomentumType::zero(), HEPMomentumType::zero(), HEPMomentumType::zero()}}};
+
+  /*
+   the interface to hadronic models in C8 has two layers. The class InteractionModel
+   (HadronInteractionModel in the case of sibyll) implements the interface to the
+   interaction model. It provides the basic interface functions getCrossSection and
+   doInteraction. The class Interaction extends the interface in InteractionModel to an
+   element C8 process sequence. Here we use only the interface class.
+  */
+  if (int_model == "sibyll") {
+    RNGManager<>::getInstance().registerRandomStream("sibyll");
+    // this is the hadron model in sibyll. can only do hadron-nucleus interactions
+    auto model = std::make_shared<corsika::sibyll::HadronInteractionModel>(
+        corsika::setup::C7trackedParticles);
+    create_events(model, int_model, projectileId, P4proj, targetId, P4targ, Nevents);
+  } else if (int_model == "epos") {
+    RNGManager<>::getInstance().registerRandomStream("epos");
+    auto model = std::make_shared<corsika::epos::InteractionModel>(
+        corsika::setup::C7trackedParticles);
+    create_events(model, int_model, projectileId, P4proj, targetId, P4targ, Nevents);
+  } else if (int_model == "pythia8") {
+    RNGManager<>::getInstance().registerRandomStream("pythia");
+    auto model = std::make_shared<corsika::pythia8::InteractionModel>(
+        corsika::setup::C7trackedParticles);
+
+    create_events(model, int_model, projectileId, P4proj, targetId, P4targ, Nevents);
+  } else {
+    RNGManager<>::getInstance().registerRandomStream("qgsjet");
+    auto model = std::make_shared<corsika::qgsjetII::InteractionModel>();
+    create_events(model, int_model, projectileId, P4proj, targetId, P4targ, Nevents);
+  }
+}

examples/stopping_power.cpp → examples/physics_examples/stopping_power.cpp

 /*
  * (c) Copyright 2019 CORSIKA Project, corsika-project@lists.kit.edu
  *
- * This software is distributed under the terms of the GNU General Public
- * Licence version 3 (GPL Version 3). See file LICENSE for a full version of
- * the license.
+ * This software is distributed under the terms of the 3-clause BSD license.
+ * See file LICENSE for a full version of the license.
  */
 
 #include <corsika/media/Environment.hpp>
 #include <corsika/media/HomogeneousMedium.hpp>
 #include <corsika/media/IMediumModel.hpp>
-#include <corsika/media/ShowerAxis.hpp>
 
 #include <corsika/framework/geometry/Sphere.hpp>
 #include <corsika/modules/BetheBlochPDG.hpp>
 #include <corsika/setup/SetupStack.hpp>
 #include <corsika/framework/core/PhysicalUnits.hpp>
+#include <corsika/framework/core/EnergyMomentumOperations.hpp>
 #include <corsika/framework/utility/CorsikaFenv.hpp>
 
 #include <fstream>
@@ -47,13 +46,13 @@ int main() {
       rootCS, 0_m, 0_m,
       112.8_km); // this is the CORSIKA 7 start of atmosphere/universe
 
-  ShowerAxis showerAxis{injectionPos, Vector<length_d>{rootCS, 0_m, 0_m, 1_m}, env, false,
-                        100};
-  BetheBlochPDG eLoss{showerAxis};
+  BetheBlochPDG eLoss;
 
-  setup::Stack stack;
+  setup::Stack<EnvType> stack;
 
-  std::ofstream file("dEdX.dat");
+  std::string fileName = "dEdX.dat";
+  CORSIKA_LOG_INFO("Writing to file {}", fileName);
+  std::ofstream file(fileName);
   file << "# beta*gamma, dE/dX / MeV/(g/cm²)" << std::endl;
 
   for (HEPEnergyType E0 = 200_MeV; E0 < 1_PeV; E0 *= 1.05) {
@@ -63,10 +62,7 @@ int main() {
     double theta = 0.;
     double phi = 0.;
 
-    auto elab2plab = [](HEPEnergyType Elab, HEPMassType m) {
-      return sqrt((Elab - m) * (Elab + m));
-    };
-    HEPMomentumType P0 = elab2plab(E0, mass);
+    HEPMomentumType P0 = calculate_momentum(E0, mass);
     auto momentumComponents = [](double theta, double phi, HEPMomentumType ptot) {
       return std::make_tuple(ptot * sin(theta) * cos(phi), ptot * sin(theta) * sin(phi),
                              -ptot * cos(theta));
@@ -75,11 +71,13 @@ int main() {
         momentumComponents(theta / 180. * constants::pi, phi / 180. * constants::pi, P0);
     auto plab = MomentumVector(rootCS, {px, py, pz});
 
-    stack.addParticle(std::make_tuple(beamCode, plab, injectionPos, 0_ns));
+    stack.addParticle(std::make_tuple(
+        beamCode, calculate_kinetic_energy(plab.getNorm(), get_mass(beamCode)),
+        plab.normalized(), injectionPos, 0_ns));
 
     auto const p = stack.getNextParticle();
     HEPEnergyType dE = eLoss.getTotalEnergyLoss(p, 1_g / square(1_cm));
     file << P0 / mass << "\t" << -dE / 1_MeV << std::endl;
   }
-  CORSIKA_LOG_INFO("finished writing dEdX.dat");
+  CORSIKA_LOG_INFO("finished writing {}", fileName);
 }

examples/physics_examples/synchrotron_clover_leaf.cpp

+/*
+ * (c) Copyright 2022 CORSIKA Project, corsika-project@lists.kit.edu
+ *
+ * This software is distributed under the terms of the 3-clause BSD license.
+ * See file LICENSE for a full version of the license.
+ */
+
+#include <corsika/framework/core/Cascade.hpp>
+#include <corsika/framework/geometry/Sphere.hpp>
+#include <corsika/framework/geometry/PhysicalGeometry.hpp>
+#include <corsika/framework/process/ProcessSequence.hpp>
+#include <corsika/framework/random/RNGManager.hpp>
+#include <corsika/framework/core/PhysicalUnits.hpp>
+#include <corsika/framework/utility/CorsikaFenv.hpp>
+#include <corsika/framework/core/Logging.hpp>
+
+#include <corsika/output/OutputManager.hpp>
+
+#include <corsika/media/Environment.hpp>
+#include <corsika/media/HomogeneousMedium.hpp>
+#include <corsika/media/IMagneticFieldModel.hpp>
+#include <corsika/media/NuclearComposition.hpp>
+#include <corsika/media/MediumPropertyModel.hpp>
+#include <corsika/media/UniformMagneticField.hpp>
+#include <corsika/media/UniformRefractiveIndex.hpp>
+
+#include <corsika/setup/SetupStack.hpp>
+#include <corsika/setup/SetupTrajectory.hpp>
+
+#include <corsika/modules/radio/RadioProcess.hpp>
+#include <corsika/modules/radio/CoREAS.hpp>
+#include <corsika/modules/radio/ZHS.hpp>
+#include <corsika/modules/radio/observers/Observer.hpp>
+#include <corsika/modules/radio/observers/TimeDomainObserver.hpp>
+#include <corsika/modules/radio/detectors/ObserverCollection.hpp>
+#include <corsika/modules/radio/propagators/DummyTestPropagator.hpp>
+#include <corsika/modules/writers/PrimaryWriter.hpp>
+
+#include <corsika/modules/TimeCut.hpp>
+
+#include <iomanip>
+#include <iostream>
+#include <limits>
+#include <string>
+#include <typeinfo>
+
+using namespace corsika;
+using namespace std;
+
+//
+// A simple shower to get the electric field trace of an electron (& a positron)
+// in order to reveal the "clover leaf" pattern of energy fluence to the ground.
+//
+
+int main() {
+
+  logging::set_level(logging::level::info);
+  corsika_logger->set_pattern("[%n:%^%-8l%$] custom pattern: %v");
+
+  CORSIKA_LOG_INFO("Synchrotron radiation");
+
+  feenableexcept(FE_INVALID);
+  RNGManager<>::getInstance().registerRandomStream("cascade");
+  std::random_device rd;
+  auto seed = rd();
+  RNGManager<>::getInstance().setSeed(seed);
+
+  OutputManager output("clover_leaf_outputs");
+
+  // create a suitable environment
+  using IModelInterface =
+      IRefractiveIndexModel<IMediumPropertyModel<IMagneticFieldModel<IMediumModel>>>;
+  using AtmModel = UniformRefractiveIndex<
+      MediumPropertyModel<UniformMagneticField<HomogeneousMedium<IModelInterface>>>>;
+  using EnvType = Environment<AtmModel>;
+  EnvType env;
+  CoordinateSystemPtr const& rootCS = env.getCoordinateSystem();
+  Point const center{rootCS, 0_m, 0_m, 0_m};
+  // a refractive index for the vacuum
+  const double ri_{1.};
+  // the composition we use for the homogeneous medium
+  NuclearComposition const Composition({Code::Nitrogen}, {1.});
+  // create magnetic field vector
+  auto const Bmag{0.00005_T};
+  MagneticFieldVector B(rootCS, 0_T, Bmag, 0_T);
+  // create a Sphere for the medium
+  auto world = EnvType::createNode<Sphere>(center, 150_km);
+  // set the environment properties
+  world->setModelProperties<AtmModel>(ri_, Medium::AirDry1Atm, B,
+                                      1_kg / (1_m * 1_m * 1_m), Composition);
+  // bind things together
+  env.getUniverse()->addChild(std::move(world));
+
+  Point injectionPos(rootCS, 0_m, 0_m, 5_km);
+
+  auto const centerX{center.getCoordinates().getX()};
+  auto const centerY{center.getCoordinates().getY()};
+  auto const centerZ{center.getCoordinates().getZ()};
+  auto const injectionPosX_{injectionPos.getCoordinates().getX()};
+  auto const injectionPosY_{injectionPos.getCoordinates().getY()};
+  auto const injectionPosZ_{injectionPos.getCoordinates().getZ()};
+  auto const triggerpoint_{Point(rootCS, injectionPosX_, injectionPosY_, injectionPosZ_)};
+
+  // the observer characteristics
+  const TimeType duration_{2e-6_s};            // 0.8e-4_s
+  const InverseTimeType sampleRate_{1e+11_Hz}; // 1e+9_Hz
+
+  // the detectors
+  ObserverCollection<TimeDomainObserver> detectorCoREAS;
+
+  std::string name_center = "CoREAS_R=0_m--Phi=0degrees";
+  auto triggertime_center{((triggerpoint_ - center).getNorm() / constants::c) - 500_ns};
+  TimeDomainObserver observer_center(name_center, center, rootCS, triggertime_center,
+                                     duration_, sampleRate_, triggertime_center);
+  detectorCoREAS.addObserver(observer_center);
+
+  for (auto radius_1 = 25_m; radius_1 <= 1000_m; radius_1 += 25_m) {
+    for (auto phi_1 = 0; phi_1 <= 315; phi_1 += 45) {
+      auto phiRad_1 = phi_1 / 180. * M_PI;
+      auto rr_1 = static_cast<int>(radius_1 / 1_m);
+      auto const point_1{Point(rootCS, centerX + radius_1 * cos(phiRad_1),
+                               centerY + radius_1 * sin(phiRad_1), centerZ)};
+      CORSIKA_LOG_INFO("Observer point: {}", point_1);
+      auto triggertime_1{((triggerpoint_ - point_1).getNorm() / constants::c) - 500_ns};
+      std::string name_1 = "CoREAS_R=" + std::to_string(rr_1) +
+                           "_m--Phi=" + std::to_string(phi_1) + "degrees";
+      TimeDomainObserver observer_1(name_1, point_1, rootCS, triggertime_1, duration_,
+                                    sampleRate_, triggertime_1);
+      detectorCoREAS.addObserver(observer_1);
+    }
+  }
+
+  // setup particle stack, and add primary particle
+  setup::Stack<EnvType> stack;
+  stack.clear();
+
+  // electron
+  const Code beamCode = Code::Electron;
+  auto const charge = get_charge(beamCode);
+  auto const mass = get_mass(beamCode);
+  auto const gyroradius = 100_m;
+  auto const pLabMag = convert_SI_to_HEP(charge * Bmag * gyroradius);
+  auto const omega_inv =
+      convert_HEP_to_SI<MassType::dimension_type>(mass) / (abs(charge) * Bmag);
+  MomentumVector const plab{rootCS, 0_MeV, 0_MeV, -10_MeV};
+  auto const Elab = sqrt(plab.getSquaredNorm() + static_pow<2>(mass));
+  auto gamma = Elab / mass;
+  TimeType const period = 2 * M_PI * omega_inv * gamma;
+
+  // positron
+  const Code beamCodeP = Code::Positron;
+  auto const chargeP = get_charge(beamCodeP);
+  auto const massP = get_mass(beamCodeP);
+  // auto const gyroradius = 100_m;
+  auto const pLabMagP = convert_SI_to_HEP(chargeP * Bmag * gyroradius);
+  auto const omega_invP =
+      convert_HEP_to_SI<MassType::dimension_type>(massP) / (abs(chargeP) * Bmag);
+  MomentumVector const plabP{rootCS, 0_MeV, 0_MeV, -10_MeV};
+  auto const ElabP = sqrt(plabP.getSquaredNorm() + static_pow<2>(massP));
+  auto gammaP = ElabP / massP;
+  TimeType const periodP = 2 * M_PI * omega_invP * gammaP;
+
+  stack.addParticle(std::make_tuple(beamCode,
+                                    calculate_kinetic_energy(plab.getNorm(), mass),
+                                    plab.normalized(), injectionPos, 0_ns));
+  stack.addParticle(std::make_tuple(beamCodeP,
+                                    calculate_kinetic_energy(plabP.getNorm(), massP),
+                                    plabP.normalized(), injectionPos, 0_ns));
+
+  // setup relevant processes
+  setup::Tracking tracking;
+
+  // the radio signal propagator
+  auto SP = make_dummy_test_radio_propagator(env);
+
+  // put radio processes here
+  RadioProcess<decltype(detectorCoREAS), CoREAS<decltype(detectorCoREAS), decltype(SP)>,
+               decltype(SP)>
+      coreas(detectorCoREAS, SP);
+  output.add("CoREAS", coreas);
+
+  TimeCut cut(period / 4);
+
+  // assemble all processes into an ordered process list
+  auto sequence = make_sequence(coreas, cut);
+
+  output.startOfLibrary();
+  // define air shower object, run simulation
+  Cascade EAS(env, tracking, sequence, output, stack);
+  EAS.run();
+
+  CORSIKA_LOG_INFO("|p| electron = {} and E electron = {}", plab.getNorm(), Elab);
+  CORSIKA_LOG_INFO("period: {}", period);
+  CORSIKA_LOG_INFO("gamma: {}", gamma);
+
+  CORSIKA_LOG_INFO("|p| positron = {} and E positron = {}", plabP.getNorm(), ElabP);
+  CORSIKA_LOG_INFO("period: {}", periodP);
+  CORSIKA_LOG_INFO("gamma: {}", gammaP);
+
+  output.endOfLibrary();
+}

examples/physics_examples/synchrotron_test_C8tracking.cpp

+/*
+ * (c) Copyright 2020 CORSIKA Project, corsika-project@lists.kit.edu
+ *
+ * This software is distributed under the terms of the 3-clause BSD license.
+ * See file LICENSE for a full version of the license.
+ */
+
+#include <corsika/framework/core/Cascade.hpp>
+#include <corsika/framework/geometry/Sphere.hpp>
+#include <corsika/framework/geometry/PhysicalGeometry.hpp>
+#include <corsika/framework/process/ProcessSequence.hpp>
+#include <corsika/framework/random/RNGManager.hpp>
+#include <corsika/framework/core/PhysicalUnits.hpp>
+#include <corsika/framework/utility/CorsikaFenv.hpp>
+#include <corsika/framework/core/Logging.hpp>
+
+#include <corsika/output/OutputManager.hpp>
+
+#include <corsika/media/Environment.hpp>
+#include <corsika/media/HomogeneousMedium.hpp>
+#include <corsika/media/IMagneticFieldModel.hpp>
+#include <corsika/media/NuclearComposition.hpp>
+#include <corsika/media/MediumPropertyModel.hpp>
+#include <corsika/media/UniformMagneticField.hpp>
+#include <corsika/media/UniformRefractiveIndex.hpp>
+
+#include <corsika/setup/SetupStack.hpp>
+#include <corsika/setup/SetupTrajectory.hpp>
+
+#include <corsika/modules/radio/RadioProcess.hpp>
+#include <corsika/modules/radio/CoREAS.hpp>
+#include <corsika/modules/radio/ZHS.hpp>
+#include <corsika/modules/radio/observers/TimeDomainObserver.hpp>
+#include <corsika/modules/radio/detectors/ObserverCollection.hpp>
+#include <corsika/modules/radio/propagators/DummyTestPropagator.hpp>
+
+#include <corsika/modules/TimeCut.hpp>
+
+#include <iomanip>
+#include <iostream>
+#include <limits>
+#include <string>
+#include <typeinfo>
+
+using namespace corsika;
+using namespace std;
+
+//
+// A simple shower to get the electric field trace of an electron using C8 tracking
+//
+int main() {
+
+  logging::set_level(logging::level::warn);
+  corsika_logger->set_pattern("[%n:%^%-8l%$] custom pattern: %v");
+
+  CORSIKA_LOG_INFO("Synchrotron radiation -- CORSIKA 8 tracking");
+  CORSIKA_LOG_INFO(" ");
+  CORSIKA_LOG_WARN(
+      "Adjust the resolution of the circular trajectory via the "
+      "maxMagneticDeflectionAngle parameter which can be found in "
+      "~/corsika/corsika/detail/modules/tracking/TrackingLeapFrogCurved.inl and "
+      "recompile example. Recommended value is 0.00001 rad.");
+
+  feenableexcept(FE_INVALID);
+  RNGManager<>::getInstance().registerRandomStream("cascade");
+  std::random_device rd;
+  auto seed = rd();
+  RNGManager<>::getInstance().setSeed(seed);
+
+  OutputManager output("synchrotron_radiation_C8tracking-output");
+
+  // set up the environment
+  using EnvironmentInterface =
+      IRefractiveIndexModel<IMediumPropertyModel<IMagneticFieldModel<IMediumModel>>>;
+  using EnvType = Environment<EnvironmentInterface>;
+  EnvType env;
+  auto& universe = *(env.getUniverse());
+  CoordinateSystemPtr const& rootCS = env.getCoordinateSystem();
+
+  auto world = EnvType::createNode<Sphere>(Point{rootCS, 0_m, 0_m, 0_m}, 150_km);
+
+  using MyHomogeneousModel = UniformRefractiveIndex<
+      MediumPropertyModel<UniformMagneticField<HomogeneousMedium<EnvironmentInterface>>>>;
+
+  auto const Bmag{0.0003809_T};
+  MagneticFieldVector B{rootCS, 0_T, 0_T, Bmag};
+
+  // the composition we use for the homogeneous medium
+  NuclearComposition const nitrogenComposition({Code::Nitrogen}, {1.});
+
+  world->setModelProperties<MyHomogeneousModel>(
+      1, Medium::AirDry1Atm, B, 1_kg / (1_m * 1_m * 1_m), nitrogenComposition);
+
+  universe.addChild(std::move(world));
+
+  // the observer locations
+  const auto point1{Point(rootCS, 30000_m, 0_m, 0_m)};
+
+  // the observer time variables
+  const TimeType t1{0.994e-4_s};
+  const TimeType t2{1.07e-4_s - 0.994e-4_s};
+  const InverseTimeType t3{5e+11_Hz};
+
+  // the observers
+  TimeDomainObserver obs1("observer CoREAS", point1, rootCS, t1, t2, t3, t1);
+  TimeDomainObserver obs2("observer ZHS", point1, rootCS, t1, t2, t3, t1);
+
+  // the detectors
+  ObserverCollection<TimeDomainObserver> detectorCoREAS;
+  ObserverCollection<TimeDomainObserver> detectorZHS;
+  detectorCoREAS.addObserver(obs1);
+  detectorZHS.addObserver(obs2);
+
+  // setup particle stack, and add primary particle
+  setup::Stack<EnvType> stack;
+  stack.clear();
+  const Code beamCode = Code::Electron;
+  auto const charge = get_charge(beamCode);
+  auto const mass = get_mass(beamCode);
+  auto const gyroradius = 100_m;
+  auto const pLabMag = convert_SI_to_HEP(charge * Bmag * gyroradius);
+  auto const omega_inv =
+      convert_HEP_to_SI<MassType::dimension_type>(mass) / (abs(charge) * Bmag);
+  MomentumVector const plab{rootCS, pLabMag, 0_MeV, 0_MeV};
+  auto const Elab = sqrt(plab.getSquaredNorm() + static_pow<2>(mass));
+  auto gamma = Elab / mass;
+  TimeType const period = 2 * M_PI * omega_inv * gamma;
+
+  Point injectionPos(rootCS, 0_m, 100_m, 0_m);
+  stack.addParticle(std::make_tuple(
+      beamCode, calculate_kinetic_energy(plab.getNorm(), get_mass(beamCode)),
+      plab.normalized(), injectionPos, 0_ns));
+
+  // setup relevant processes
+  setup::Tracking tracking;
+
+  // the radio signal propagator
+  auto SP = make_dummy_test_radio_propagator(env);
+
+  // put radio processes here
+  RadioProcess<decltype(detectorCoREAS), CoREAS<decltype(detectorCoREAS), decltype(SP)>,
+               decltype(SP)>
+      coreas(detectorCoREAS, SP);
+  output.add("CoREAS", coreas);
+
+  RadioProcess<decltype(detectorZHS), ZHS<decltype(detectorZHS), decltype(SP)>,
+               decltype(SP)>
+      zhs(detectorZHS, SP);
+  output.add("ZHS", zhs);
+
+  TimeCut cut(period);
+
+  // assemble all processes into an ordered process list
+  auto sequence = make_sequence(coreas, zhs, cut);
+
+  output.startOfLibrary();
+  // define air shower object, run simulation
+  Cascade EAS(env, tracking, sequence, output, stack);
+  EAS.run();
+
+  CORSIKA_LOG_INFO("|p| = {} and E = {}", plab.getNorm(), Elab);
+  CORSIKA_LOG_INFO("period: {}", period);
+  CORSIKA_LOG_INFO("gamma: {}", gamma);
+
+  output.endOfLibrary();
+}

examples/physics_examples/synchrotron_test_manual_tracking.cpp

+/*
+ * (c) Copyright 2020 CORSIKA Project, corsika-project@lists.kit.edu
+ *
+ * This software is distributed under the terms of the 3-clause BSD license.
+ * See file LICENSE for a full version of the license.
+ */
+
+#include <corsika/framework/geometry/Sphere.hpp>
+#include <corsika/framework/geometry/PhysicalGeometry.hpp>
+#include <corsika/framework/process/ProcessSequence.hpp>
+#include <corsika/framework/core/PhysicalUnits.hpp>
+
+#include <corsika/output/OutputManager.hpp>
+
+#include <corsika/media/Environment.hpp>
+#include <corsika/media/HomogeneousMedium.hpp>
+#include <corsika/media/IMagneticFieldModel.hpp>
+#include <corsika/media/NuclearComposition.hpp>
+#include <corsika/media/MediumPropertyModel.hpp>
+#include <corsika/media/UniformMagneticField.hpp>
+#include <corsika/media/UniformRefractiveIndex.hpp>
+
+#include <corsika/setup/SetupStack.hpp>
+#include <corsika/setup/SetupTrajectory.hpp>
+
+#include <corsika/modules/radio/RadioProcess.hpp>
+#include <corsika/modules/radio/CoREAS.hpp>
+#include <corsika/modules/radio/ZHS.hpp>
+#include <corsika/modules/radio/observers/TimeDomainObserver.hpp>
+#include <corsika/modules/radio/detectors/ObserverCollection.hpp>
+#include <corsika/modules/radio/propagators/DummyTestPropagator.hpp>
+
+#include <iomanip>
+#include <iostream>
+#include <limits>
+#include <string>
+
+using namespace corsika;
+using namespace std;
+
+//
+// A simple example to get the electric field trace of an electron using manual tracking
+//
+int main() {
+
+  // create a suitable environment
+  using IModelInterface =
+      IRefractiveIndexModel<IMediumPropertyModel<IMagneticFieldModel<IMediumModel>>>;
+  using AtmModel = UniformRefractiveIndex<
+      MediumPropertyModel<UniformMagneticField<HomogeneousMedium<IModelInterface>>>>;
+  using EnvType = Environment<AtmModel>;
+  EnvType env;
+  CoordinateSystemPtr const& rootCS = env.getCoordinateSystem();
+  Point const center{rootCS, 0_m, 0_m, 0_m};
+  // a refractive index for the vacuum
+  const double ri_{1};
+  // the constant density
+  const auto density{19.2_g / cube(1_cm)};
+  // the composition we use for the homogeneous medium
+  NuclearComposition const Composition({Code::Nitrogen}, {1.});
+  // create magnetic field vector
+  Vector B1(rootCS, 0_T, 0_T, 0.3809_T);
+  // create a Sphere for the medium
+  auto Medium =
+      EnvType::createNode<Sphere>(center, 1_km * std::numeric_limits<double>::infinity());
+  // set the environment properties
+  auto const props = Medium->setModelProperties<AtmModel>(ri_, Medium::AirDry1Atm, B1,
+                                                          density, Composition);
+  // bind things together
+  env.getUniverse()->addChild(std::move(Medium));
+  auto const& node_ = env.getUniverse()->getChildNodes().front();
+
+  // the observers location
+  const auto point1{Point(rootCS, 30000_m, 0_m, 0_m)};
+
+  // create times for the observer
+  const TimeType start{0.994e-4_s};
+  const TimeType duration{1.07e-4_s - 0.994e-4_s};
+  // 3 km observer
+  //    const TimeType start{0.994e-5_s};
+  //    const TimeType duration{1.7e-5_s - 0.994e-5_s};
+  const InverseTimeType sampleRate_{5e+11_Hz};
+
+  std::cout << "number of points in time: " << duration * sampleRate_ << std::endl;
+
+  // create 2 observers
+  TimeDomainObserver obs1("CoREAS observer", point1, rootCS, start, duration, sampleRate_,
+                          start);
+  TimeDomainObserver obs2("ZHS observer", point1, rootCS, start, duration, sampleRate_,
+                          start);
+
+  // construct a radio detector instance to store our observers
+  ObserverCollection<TimeDomainObserver> detectorCoREAS;
+  ObserverCollection<TimeDomainObserver> detectorZHS;
+
+  // add the observers to the detector
+  detectorCoREAS.addObserver(obs1);
+  detectorZHS.addObserver(obs2);
+
+  // create a new stack for each trial
+  setup::Stack<EnvType> stack;
+  stack.clear();
+
+  const Code particle{Code::Electron};
+  const HEPMassType pmass{get_mass(particle)};
+
+  // construct an energy // move in the for loop
+  const HEPEnergyType E0{11.4_MeV};
+
+  // construct the output manager
+  OutputManager outputs("synchrotron_radiation_manual_tracking-output");
+
+  // the radio signal propagator
+  auto SP = make_dummy_test_radio_propagator(env);
+
+  // create a radio process instance using CoREAS
+  RadioProcess<ObserverCollection<TimeDomainObserver>,
+               CoREAS<ObserverCollection<TimeDomainObserver>, decltype(SP)>, decltype(SP)>
+      coreas(detectorCoREAS, SP);
+  // register CoREAS to the output manager
+  outputs.add("CoREAS", coreas);
+
+  // create a radio process instance using ZHS
+  RadioProcess<ObserverCollection<TimeDomainObserver>,
+               ZHS<ObserverCollection<TimeDomainObserver>, decltype(SP)>, decltype(SP)>
+      zhs(detectorZHS, SP);
+  // register ZHS to the output manager
+  outputs.add("ZHS", zhs);
+
+  // trigger the start of the library and the first event
+  outputs.startOfLibrary();
+  outputs.startOfShower();
+
+  // the number of points that make up the circle
+  int const n_points{100000};
+  LengthType const radius{100_m};
+  TimeType timeCounter{0._s};
+
+  // loop over the circular trajectory (this produces 1 pulse)
+  for (size_t i = 0; i <= (n_points); i++) {
+    Point const point_1(rootCS, {radius * cos(M_PI * 2 * i / n_points),
+                                 radius * sin(M_PI * 2 * i / n_points), 0_m});
+    Point const point_2(rootCS, {radius * cos(M_PI * 2 * (i + 1) / n_points),
+                                 radius * sin(M_PI * 2 * (i + 1) / n_points), 0_m});
+    TimeType t{(point_2 - point_1).getNorm() / (0.999 * constants::c)};
+    timeCounter = timeCounter + t;
+    VelocityVector v{(point_2 - point_1) / t};
+    auto beta{v / constants::c};
+    auto gamma{E0 / pmass};
+    auto plab{beta * pmass * gamma};
+    Line l{point_1, v};
+    StraightTrajectory track{l, t};
+    auto particle1{stack.addParticle(std::make_tuple(
+        particle, calculate_kinetic_energy(plab.getNorm(), get_mass(particle)),
+        plab.normalized(), point_1, timeCounter))};
+    particle1.setNode(node_.get());
+    Step step(particle1, track);
+    coreas.doContinuous(step, true);
+    zhs.doContinuous(step, true);
+    stack.clear();
+  }
+
+  // trigger the manager to write the data to disk
+  outputs.endOfShower();
+  outputs.endOfLibrary();
+}

examples/vertical_EAS.cpp

-/*
- * (c) Copyright 2018 CORSIKA Project, corsika-project@lists.kit.edu
- *
- * This software is distributed under the terms of the GNU General Public
- * Licence version 3 (GPL Version 3). See file LICENSE for a full version of
- * the license.
- */
-
-#define TRACE
-
-/* clang-format off */
-// InteractionCounter used boost/histogram, which
-// fails if boost/type_traits have been included before. Thus, we have
-// to include it first...
-#include <corsika/framework/process/InteractionCounter.hpp>
-/* clang-format on */
-#include <corsika/framework/geometry/Plane.hpp>
-#include <corsika/framework/geometry/Sphere.hpp>
-#include <corsika/framework/core/Logging.hpp>
-#include <corsika/framework/utility/SaveBoostHistogram.hpp>
-#include <corsika/framework/process/ProcessSequence.hpp>
-#include <corsika/framework/process/SwitchProcessSequence.hpp>
-#include <corsika/framework/process/InteractionCounter.hpp>
-#include <corsika/framework/random/RNGManager.hpp>
-#include <corsika/framework/core/PhysicalUnits.hpp>
-#include <corsika/framework/utility/CorsikaFenv.hpp>
-#include <corsika/framework/core/Cascade.hpp>
-#include <corsika/framework/geometry/PhysicalGeometry.hpp>
-
-#include <corsika/output/OutputManager.hpp>
-#include <corsika/output/NoOutput.hpp>
-
-#include <corsika/media/Environment.hpp>
-#include <corsika/media/FlatExponential.hpp>
-#include <corsika/media/HomogeneousMedium.hpp>
-#include <corsika/media/IMagneticFieldModel.hpp>
-#include <corsika/media/LayeredSphericalAtmosphereBuilder.hpp>
-#include <corsika/media/NuclearComposition.hpp>
-#include <corsika/media/MediumPropertyModel.hpp>
-#include <corsika/media/UniformMagneticField.hpp>
-#include <corsika/media/ShowerAxis.hpp>
-#include <corsika/media/SlidingPlanarExponential.hpp>
-
-#include <corsika/modules/BetheBlochPDG.hpp>
-#include <corsika/modules/LongitudinalProfile.hpp>
-#include <corsika/modules/ObservationPlane.hpp>
-#include <corsika/modules/StackInspector.hpp>
-#include <corsika/modules/TrackWriter.hpp>
-#include <corsika/modules/ParticleCut.hpp>
-#include <corsika/modules/Pythia8.hpp>
-#include <corsika/modules/Sibyll.hpp>
-#include <corsika/modules/UrQMD.hpp>
-#include <corsika/modules/Epos.hpp>
-
-#include <corsika/setup/SetupStack.hpp>
-#include <corsika/setup/SetupTrajectory.hpp>
-
-#include <iomanip>
-#include <iostream>
-#include <limits>
-#include <string>
-
-/*
-  NOTE, WARNING, ATTENTION
-
-  The .../Random.hpppp implement the hooks of external modules to the C8 random
-  number generator. It has to occur excatly ONCE per linked
-  executable. If you include the header below multiple times and
-  link this togehter, it will fail.
- */
-#include <corsika/modules/Random.hpp>
-
-using namespace corsika;
-using namespace std;
-
-using Particle = setup::Stack::particle_type;
-
-void registerRandomStreams(int seed) {
-  RNGManager<>::getInstance().registerRandomStream("cascade");
-  RNGManager<>::getInstance().registerRandomStream("sibyll");
-  RNGManager<>::getInstance().registerRandomStream("pythia");
-  RNGManager<>::getInstance().registerRandomStream("urqmd");
-  RNGManager<>::getInstance().registerRandomStream("proposal");
-  if (seed == 0) {
-    std::random_device rd;
-    seed = rd();
-    cout << "new random seed (auto) " << seed << endl;
-  }
-  RNGManager<>::getInstance().setSeed(seed);
-}
-
-template <typename T>
-using MyExtraEnv = MediumPropertyModel<UniformMagneticField<T>>;
-
-// argv : 1.number of nucleons, 2.number of protons,
-//        3.total energy in GeV, 4.number of showers,
-//        5.seed (0 by default to generate random values for all)
-
-int main(int argc, char** argv) {
-
-  logging::set_level(logging::level::info);
-
-  CORSIKA_LOG_INFO("vertical_EAS");
-
-  if (argc < 4) {
-    std::cerr << "usage: vertical_EAS <A> <Z> <energy/GeV> [seed] \n"
-                 "       if A=0, Z is interpreted as PDG code \n"
-                 "       if no seed is given, a random seed is chosen \n"
-              << std::endl;
-    return 1;
-  }
-  feenableexcept(FE_INVALID);
-
-  int seed = 0;
-
-  if (argc > 4) { seed = std::stoi(std::string(argv[4])); }
-
-  // initialize random number sequence(s)
-  registerRandomStreams(seed);
-
-  // setup environment, geometry
-  using EnvType = setup::Environment;
-  EnvType env;
-  CoordinateSystemPtr const& rootCS = env.getCoordinateSystem();
-  Point const center{rootCS, 0_m, 0_m, 0_m};
-  auto builder = make_layered_spherical_atmosphere_builder<
-      setup::EnvironmentInterface, MyExtraEnv>::create(center,
-                                                       constants::EarthRadius::Mean,
-                                                       Medium::AirDry1Atm,
-                                                       MagneticFieldVector{rootCS, 0_T,
-                                                                           50_uT, 0_T});
-  builder.setNuclearComposition(
-      {{Code::Nitrogen, Code::Oxygen},
-       {0.7847f, 1.f - 0.7847f}}); // values taken from AIRES manual, Ar removed for now
-
-  builder.addExponentialLayer(1222.6562_g / (1_cm * 1_cm), 994186.38_cm, 2_km);
-  builder.addExponentialLayer(1222.6562_g / (1_cm * 1_cm), 994186.38_cm, 4_km);
-  builder.addExponentialLayer(1144.9069_g / (1_cm * 1_cm), 878153.55_cm, 10_km);
-  builder.addExponentialLayer(1305.5948_g / (1_cm * 1_cm), 636143.04_cm, 40_km);
-  builder.addExponentialLayer(540.1778_g / (1_cm * 1_cm), 772170.16_cm, 100_km);
-  builder.addLinearLayer(1e9_cm, 112.8_km + constants::EarthRadius::Mean);
-  builder.assemble(env);
-
-  // pre-setup particle stack
-  unsigned short const A = std::stoi(std::string(argv[1]));
-  Code beamCode;
-  HEPEnergyType mass;
-  unsigned short Z = 0;
-  if (A > 0) {
-    beamCode = Code::Nucleus;
-    Z = std::stoi(std::string(argv[2]));
-    mass = get_nucleus_mass(A, Z);
-  } else {
-    int pdg = std::stoi(std::string(argv[2]));
-    beamCode = convert_from_PDG(PDGCode(pdg));
-    mass = get_mass(beamCode);
-  }
-  HEPEnergyType const E0 = 1_GeV * std::stof(std::string(argv[3]));
-  double theta = 0.;
-  double phi = 180.;
-  auto const thetaRad = theta / 180. * constants::pi;
-  auto const phiRad = phi / 180. * constants::pi;
-
-  auto elab2plab = [](HEPEnergyType Elab, HEPMassType m) {
-    return sqrt((Elab - m) * (Elab + m));
-  };
-  HEPMomentumType P0 = elab2plab(E0, mass);
-  auto momentumComponents = [](double theta, double phi, HEPMomentumType ptot) {
-    return std::make_tuple(ptot * sin(theta) * cos(phi), ptot * sin(theta) * sin(phi),
-                           -ptot * cos(theta));
-  };
-
-  auto const [px, py, pz] = momentumComponents(thetaRad, phiRad, P0);
-  auto plab = MomentumVector(rootCS, {px, py, pz});
-  cout << "input particle: " << beamCode << endl;
-  cout << "input angles: theta=" << theta << ",phi=" << phi << endl;
-  cout << "input momentum: " << plab.getComponents() / 1_GeV
-       << ", norm = " << plab.getNorm() << endl;
-
-  auto const observationHeight = 0_km + builder.getPlanetRadius();
-  auto const injectionHeight = 111.75_km + builder.getPlanetRadius();
-  auto const t = -observationHeight * cos(thetaRad) +
-                 sqrt(-static_pow<2>(sin(thetaRad) * observationHeight) +
-                      static_pow<2>(injectionHeight));
-  Point const showerCore{rootCS, 0_m, 0_m, observationHeight};
-  Point const injectionPos =
-      showerCore + DirectionVector{rootCS,
-                                   {-sin(thetaRad) * cos(phiRad),
-                                    -sin(thetaRad) * sin(phiRad), cos(thetaRad)}} *
-                       t;
-
-  std::cout << "point of injection: " << injectionPos.getCoordinates() << std::endl;
-
-  // we make the axis much longer than the inj-core distance since the
-  // profile will go beyond the core, depending on zenith angle
-  std::cout << "shower axis length: " << (showerCore - injectionPos).getNorm() * 1.5
-            << std::endl;
-
-  ShowerAxis const showerAxis{injectionPos, (showerCore - injectionPos) * 1.5, env, false,
-                              1000};
-
-  // create the output manager that we then register outputs with
-  OutputManager output("vertical_EAS_outputs");
-
-  // setup processes, decays and interactions
-
-  corsika::sibyll::Interaction sibyll;
-  InteractionCounter sibyllCounted(sibyll);
-
-  corsika::sibyll::NuclearInteraction sibyllNuc(sibyll, env);
-  InteractionCounter sibyllNucCounted(sibyllNuc);
-
-  corsika::pythia8::Decay decayPythia;
-
-  // use sibyll decay routine for decays of particles unknown to pythia
-  corsika::sibyll::Decay decaySibyll{{
-      Code::N1440Plus,
-      Code::N1440MinusBar,
-      Code::N1440_0,
-      Code::N1440_0Bar,
-      Code::N1710Plus,
-      Code::N1710MinusBar,
-      Code::N1710_0,
-      Code::N1710_0Bar,
-
-      Code::Pi1300Plus,
-      Code::Pi1300Minus,
-      Code::Pi1300_0,
-
-      Code::KStar0_1430_0,
-      Code::KStar0_1430_0Bar,
-      Code::KStar0_1430_Plus,
-      Code::KStar0_1430_MinusBar,
-  }};
-
-  decaySibyll.printDecayConfig();
-
-  ParticleCut cut{60_GeV, 60_GeV, 60_GeV, 60_GeV, true};
-
-  corsika::urqmd::UrQMD urqmd;
-  InteractionCounter urqmdCounted{urqmd};
-  StackInspector<setup::Stack> stackInspect(50000, false, E0);
-
-  // assemble all processes into an ordered process list
-  struct EnergySwitch {
-    HEPEnergyType cutE_;
-    EnergySwitch(HEPEnergyType cutE)
-        : cutE_(cutE) {}
-    bool operator()(const Particle& p) { return (p.getEnergy() < cutE_); }
-  };
-  auto hadronSequence = make_select(EnergySwitch(55_GeV), urqmdCounted,
-                                    make_sequence(sibyllNucCounted, sibyllCounted));
-  auto decaySequence = make_sequence(decayPythia, decaySibyll);
-
-  // directory for outputs
-  string const labHist_file = "inthist_lab_verticalEAS.npz";
-  string const cMSHist_file = "inthist_cms_verticalEAS.npz";
-  string const longprof_file = "longprof_verticalEAS.txt";
-
-  // setup particle stack, and add primary particle
-  setup::Stack stack;
-  stack.clear();
-
-  if (A > 1) {
-    stack.addParticle(std::make_tuple(beamCode, plab, injectionPos, 0_ns, A, Z));
-
-  } else {
-    if (A == 1) {
-      if (Z == 1) {
-        stack.addParticle(std::make_tuple(Code::Proton, plab, injectionPos, 0_ns));
-      } else if (Z == 0) {
-        stack.addParticle(std::make_tuple(Code::Neutron, plab, injectionPos, 0_ns));
-      } else {
-        std::cerr << "illegal parameters" << std::endl;
-        return EXIT_FAILURE;
-      }
-    } else {
-      stack.addParticle(std::make_tuple(beamCode, plab, injectionPos, 0_ns));
-    }
-  }
-
-  BetheBlochPDG emContinuous(showerAxis);
-
-  TrackWriter trackWriter;
-  output.add("tracks", trackWriter); // register TrackWriter
-
-  LongitudinalProfile longprof{showerAxis};
-
-  Plane const obsPlane(showerCore, DirectionVector(rootCS, {0., 0., 1.}));
-  ObservationPlane<setup::Tracking, NoOutput> observationLevel(
-      obsPlane, DirectionVector(rootCS, {1., 0., 0.}));
-  // register the observation plane with the output
-  output.add("particles", observationLevel);
-
-  auto sequence = make_sequence(stackInspect, hadronSequence, decaySequence, emContinuous,
-                                cut, trackWriter, observationLevel, longprof);
-
-  // define air shower object, run simulation
-  setup::Tracking tracking;
-  Cascade EAS(env, tracking, sequence, output, stack);
-  output.startOfShower();
-  EAS.run();
-  output.endOfShower();
-
-  cut.showResults();
-  // emContinuous.showResults();
-  observationLevel.showResults();
-  const HEPEnergyType Efinal = cut.getCutEnergy() + cut.getInvEnergy() +
-                               cut.getEmEnergy() + // emContinuous.getEnergyLost() +
-                               observationLevel.getEnergyGround();
-  cout << "total cut energy (GeV): " << Efinal / 1_GeV << endl
-       << "relative difference (%): " << (Efinal / E0 - 1) * 100 << endl;
-  observationLevel.reset();
-  cut.reset();
-  // emContinuous.reset();
-
-  auto const hists = sibyllCounted.getHistogram() + sibyllNucCounted.getHistogram() +
-                     urqmdCounted.getHistogram();
-
-  save_hist(hists.labHist(), labHist_file, true);
-  save_hist(hists.CMSHist(), cMSHist_file, true);
-  longprof.save(longprof_file);
-
-  output.endOfLibrary();
-}

externals/cnpy/CMakeLists.txt

@@ -9,12 +9,12 @@ set (
   )
 
 add_library (cnpy STATIC ${CNPY_SOURCES})
-
+find_package(ZLIB REQUIRED)
 # target dependencies on other libraries (also the header onlys)
 target_link_libraries (
   cnpy
   PUBLIC
-  CONAN_PKG::zlib
+  ZLIB::ZLIB
   )
 
 target_include_directories (

externals/lcov/.version

-VERSION=1.14
-RELEASE=1
-FULL=1.14

externals/lcov/CHANGES

-commit 6c7ad581ab9ed66f80050970c0d559c6684613b7 (HEAD, tag: v1.14, origin/master, origin/HEAD, master)
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Thu Feb 28 18:01:39 2019 +0100
-
-    lcov: Finalize release 1.14
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-
-commit 29814f18ec207ebaefa7b41f6e5acc4eca6d7a7a
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Thu Feb 28 17:31:17 2019 +0100
-
-    geninfo: Fix missing FN: entries in result files
-    
-    geninfo sometimes fails to correctly collect function starting lines for
-    some source files, resulting in output files with missing FN: lines.
-    Also such functions are missing from the function list in HTML output.
-    
-    The problem occurs when
-      a) multiple source files contribute to a function implementation (e.g.
-         via including code), and
-      b) the source file that contains the initial function definition
-         is not the source file that contains the most function
-         definitions
-    
-    The problem occurs due to a heuristic in function graph_find_base() that
-    incorrectly determines the source file for a function in this situation.
-    
-    Fix this by using the first file that contributes to a function as the
-    base source file for that function. Only apply this change to data
-    collected using GCC versions 4 and above since earlier versions did not
-    produce stable file orders in graph files.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-    Reported-by: Joshua Cranmer
-
-commit 74bae96e8ef724eb9dbdf126adad17505375e149
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Thu Feb 28 16:15:22 2019 +0100
-
-    Makefile: Make Perl path install-time configurable
-    
-    Add support for specifying the Perl interpreter path used in installed
-    Perl scripts. If no path is specified, the default '/usr/bin/perl' is
-    used.
-    
-    Set variable LCOV_PERL_PATH to specify a different path, for example:
-    
-      make install LCOV_PERL_PATH=/usr/local/bin/perl
-    
-    Unset this variable to keep the current path:
-    
-      make install LCOV_PERL_PATH=
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-
-commit 0b378cba2c0f93d728627aa8750849d3c33de0e1
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Thu Feb 28 14:21:18 2019 +0100
-
-    bin,test: Use /usr/bin/env to locate script interpreters
-    
-    Make use of the /usr/bin/env tool to locate script interpreters. This is
-    needed to locate the correct interpreter in non-standard environments.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-    Suggested-by: Bjørn Forsman <bjorn.forsman@gmail.com>
-    Suggested-by: Mario Costa
-
-commit 2ff99aefbd0c80fe0cfddf1e09a596d7344533e1
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Thu Feb 28 14:09:42 2019 +0100
-
-    bin/*: Remove '-w' from interpreter specifications
-    
-    Replace '-w' flag from Perl interpreter specifications with 'use strict'
-    directive. This is done in preparation of using a more flexible
-    interpreter specification.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-
-commit 3b378b0e76be95971680056d864d0e13f4a08557
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Wed Feb 27 16:33:42 2019 +0100
-
-    geninfo: Fix errors while resolving /././ path components
-    
-    Trying to collect code coverage data for source code that contains
-    repeat ./ references in a path components fails with the following
-    error message:
-    
-      geninfo: WARNING: cannot find an entry for <name>.gcov in .gcno file,
-               skipping file!
-    
-    This is caused by a bug in path normalization function
-    solve_relative_path() that does not correctly process adjacent ./
-    references.
-    
-    Fix this by repeating the resolution of ./ references in path
-    components.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-    Reported-by: Joshua Cranmer
-
-commit 42b55f5a497d2286566d0dd411e3e52fd4d50469
-Author: iignatyev <igor.v.ignatiev@gmail.com>
-Date:   Wed Feb 6 11:35:02 2019 -0800
-
-    geninfo: preserve-paths makes gcov to fail for long pathnames
-    
-    geninfo uses '--preserve-paths' gcov option whenever gcov supports it, this
-    forces gcov to use a whole pathname as a filename for .gcov files. So in cases
-    of quite large pathnames, gcov isn't able to create .gcov files and hence
-    geninfo can't get any data. The fix replaces usage '--preserve-paths' with
-    '--hash-filenames' when it is available.
-    
-    Signed-off-by: Igor Ignatev <igor.v.ignatiev@gmail.com>
-
-commit 04335632c371b5066e722298c9f8c6f11b210201
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Fri Jan 11 13:53:33 2019 +0100
-
-    geninfo: Fix "Can't use an undefined value" error
-    
-    When run on data for source code that causes gcc 8 to generate
-    artificial functions, geninfo emits warnings and eventually aborts
-    processing:
-    
-      geninfo: Use of uninitialized value in hash element at
-               /usr/local/bin/geninfo line 3001.
-      geninfo: Can't use an undefined value as an ARRAY reference at
-               /usr/local/bin/geninfo line 2889.
-    
-    This problem was introduced by commit 9aa0d14a ("geninfo: Ignore
-    artificial functions during --initial"). It is the result of an
-    incomplete removal of artificial functions from internal data.
-    
-    Fix this by explicitcly removing known artificial functions after
-    parsing of graph files completes.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-    Reported-by: Steven Peters <scpeters@osrfoundation.org>
-
-commit 9aa0d14af4446ef46d80356849a97bc961a91f97
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Thu Jan 10 13:20:15 2019 +0100
-
-    geninfo: Ignore artificial functions during --initial
-    
-    Graph files generated by gcc 8 may contain "artifical" functions that do
-    not exist in a source file. geninfo incorrectly generates coverage data
-    for these functions when run with option --initial.
-    
-    Fix this by filtering out artifical functions when generating initial
-    coverage data.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-    Reported-by: Marcin Konarski <marcin.konarski@codestation.org>
-
-commit 1e0df571198229b4701100ce5f596cf1658ede4b
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Thu Jan 10 11:39:07 2019 +0100
-
-    geninfo: Fix data collection for files containing templates
-    
-    When using gcc 8, lcov/geninfo produces corrupt coverage output for
-    source code that contains templates or other constructs that cause gcov
-    to produce multiple versions of output for some lines and branches.
-    
-    This is caused by an incorrect check for duplicate output in function
-    read_gcov_file() that is triggered when a template consists of multiple
-    lines, or contains branches.
-    
-    Fix this by ensuring that duplicate lines in per-instance gcov output are
-    correctly ignored. Only the initial occurrence of each line containing
-    the combined coverage of all instances will be processed by geninfo.
-    
-    Note that for branch coverage, gcov doesn't provide a combined view and
-    geninfo processes all branches provided. This should not be a problem
-    though as genhtml will combine the branch data when generating HTML
-    output.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-
-commit abd8bed2b013334d4ef978abadbfff6cc6f3d55d
-Author: MarcoFalke <falke.marco@gmail.com>
-Date:   Tue Jan 8 12:49:00 2019 +0100
-
-    genhtml: Unconditionally include anchor for each named line
-    
-    This helps with referencing the line in the html when sharing links.
-    
-    Signed-off-by: MarcoFalke <falke.marco@gmail.com>
-
-commit 28675dc7564aaa1ad231a7ac23106512a3956d68
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Tue Dec 18 13:07:58 2018 +0100
-
-    genhtml: Use gmtime for SOURCE_DATE_EPOCH conversion
-    
-    By changing that localtime to gmtime the "Known bug" section of the
-    commit message can be removed.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-    Suggested-by: Bjørn Forsman <bjorn.forsman@gmail.com>
-
-commit 180286bec651928c41de4d6ce3a8760678b38f60
-Author: Bjørn Forsman <bjorn.forsman@gmail.com>
-Date:   Tue Dec 4 14:30:28 2018 +0100
-
-    genhtml: honor the SOURCE_DATE_EPOCH variable
-    
-    Implement the SOURCE_DATE_EPOCH specification[1] for reproducible
-    builds. If SOURCE_DATE_EPOCH is set, use it as timestamp instead of the
-    current time.
-    
-    In this context, reproducible builds means reproducible HTML coverage
-    reports.
-    
-    Known bug: the specification[1] says to defer converting the timestamp
-    to local timezone at presentation time. This is currently not happening;
-    it's converted at build time.
-    
-    [1] https://reproducible-builds.org/specs/source-date-epoch/
-    
-    Signed-off-by: Bjørn Forsman <bjorn.forsman@gmail.com>
-
-commit 41e07cadeeae3054ac22202d5b0b0f0ef6e26467
-Author: Bjørn Forsman <bjorn.forsman@gmail.com>
-Date:   Tue Dec 4 14:30:27 2018 +0100
-
-    Tolerate CDPATH being set
-    
-    If CDPATH is set, cd will print the path it enters, resulting in TOOLDIR
-    containing the path twice, separated by a newline.
-    
-    Signed-off-by: Bjørn Forsman <bjorn.forsman@gmail.com>
-
-commit a3bbe8f0398a3c36b4228cc173e4739d27a863e1
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Mon Dec 10 13:58:10 2018 +0100
-
-    CONTRIBUTING: Clarify patch format requirements
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-
-commit e6750800fe4cb89eda1ff80b7a5fe70fe87ede36
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Tue Nov 13 17:28:17 2018 +0100
-
-    geninfo: Fix accounting of basic blocks in exceptional paths
-    
-    Basic blocks that are not executed and are only reachable via
-    exceptional paths are marked with a '%%%%%' marker in the GCOV output of
-    current GCC versions. Fix geninfo to also recognize this marker.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-    Reported-by: trotux (github user)
-
-commit 94eac0ee870e58630d8052dca1181b0cf802525f
-Author: Peter Oberparleiter <oberpar@linux.ibm.com>
-Date:   Mon Jul 16 13:24:58 2018 +0200
-
-    lcov: Fix branch coverage summary
-    
-    When combining two data files A (without branch coverage data) and B
-    (with branch coverage data), lcov will incorrectly report no branch
-    coverage data for the resulting file in program output, even though the
-    resulting file contains branch coverage data. This only happens when A
-    is specified first during the add operation.
-    
-    This is due to a bug in lcov that loses the correctly combined branch
-    coverage data internally in function brcount_db_combine() when its first
-    parameter is undefined. Fix this by ensuring that the first parameter is
-    an empty hash reference instead.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
-
-commit a5dd9529f9232b8d901a4d6eb9ae54cae179e5b3
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Wed Mar 7 14:18:55 2018 +0100
-
-    geninfo: Add gcc 8 support
-    
-    Fix errors and incorrect data when trying to collect coverage data
-    for programs compiled with gcc 8.
-    
-    Covers the following gcov-related changes in gcc:
-    
-    .gcov-file format:
-      - Line coverage data can appear multiple times for the same line
-      - Line coverage count can be suffixed by '*' to indicated unexecuted
-        basic blocks in that line
-    
-    .gcno-file format:
-      - new header field 'support unexecuted blocks flag'
-      - new function record fields 'column number', 'ending line number',
-        and 'compiler-generated entity flag'
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit c30d88a3a8096dbb3f968de999480c3dc2dedb5f
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Tue Jan 30 15:12:09 2018 +0100
-
-    genhtml: Implement option to show miss counts
-    
-    Add new command line option --missed that can be used to show the
-    number of missed lines, functions, or branches.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 999abf2447b4df373b135dc3f8ee317350bd95f8
-Author: Benoit Belley <Benoit.Belley@autodesk.com>
-Date:   Fri Oct 6 10:01:28 2017 -0400
-
-    Adding the --include and --exclude options to lcov and geninfo
-    
-    * The --include command-line option allows the user to specify a regular
-      expression for the source files to be included. The command-line
-      option can be repeated to specify multiple patterns. The coverage
-      information is only included for the source files matching at least
-      one of the patterns.
-    
-      The "lcov --capture --include" (or "geninfo --include") option is
-      similar in functionality to the "lcov --extract" command-line
-      option. But, by directly using applying the pattern while capturing
-      coverage data one can often avoid having to run "lcov --extract" as a
-      second pass.
-    
-    * The --exclude command-line option allows the user to specify a regular
-      expression for the source files to be excluded. The command-line
-      option can be repeated to specify multiple patterns. The coverage
-      information is excluded for source files matching at least one of the
-      patterns.
-    
-      The "lcov --capture --exclude" (or "geninfo --exclude") option is
-      similar in functionality to the "lcov --extract" command-line
-      option. But, by directly using applying the pattern while capturing
-      coverage data one can often avoid having to run "lcov --remove" as a
-      second pass.
-    
-    * On one of our code base at Autodesk, this speeds-up the generation of
-      HTML code coverage reports by a factor of 3X.
-    
-    Signed-off-by: Benoit Belley <benoit.belley@autodesk.com>
-
-commit b6a11368c3cdc86c4e147ccd8e539918dfe37900
-Author: Ziqian SUN (Zamir) <zsun@redhat.com>
-Date:   Wed Jul 19 10:58:24 2017 +0800
-
-    Resolve some rpmlint issue in SPEC.
-    
-    Following messages reported by rpmlint on RHEL is fixed by this patch:
-    lcov.src: W: invalid-license GPL
-    lcov.src:9: W: hardcoded-path-in-buildroot-tag
-    /var/tmp/%{name}-%{version}-root
-    lcov.src: E: specfile-error warning: bogus date in %changelog: Fri Oct 8
-    2002 Peter Oberparleiter (Peter.Oberparleiter@de.ibm.com)
-    lcov.noarch: W: non-conffile-in-etc /etc/lcovrc
-    
-    Signed-off-by: Ziqian SUN (Zamir) <zsun@redhat.com>
-    [oberpar@linux.vnet.ibm.com: Corrected license to GPLv2+]
-
-commit a77a7628ef5377c525a0d4904cc0b73eeede4d7c
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Fri Apr 7 15:43:28 2017 +0200
-
-    genhtml: Reduce path resolution overhead
-    
-    Reduce overhead when reading coverage data files by consolidating
-    calls to Cwd:cwd().
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 526c5148ac0add40ef1224d2cdabdec73ce3f899
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Fri Apr 7 15:37:52 2017 +0200
-
-    genhtml: Reduce load times for complex coverage data files
-    
-    genhtml uses a significant amount of time loading coverage data files
-    containing complex branch coverage data (i.e. data with a large number
-    of branches per basic block). Most of this time is spent storing
-    branch coverage data in a vector-based data representation, with an
-    unnecessary amount of cross-checking being done for existing branch
-    data.
-    
-    Fix this by replacing the vector based data representation by two
-    separate representations, scalar for storage and hash for processing,
-    and by moving cross-checking out of the hot path. This results in a
-    significant speedup at the cost of a minor increase in memory usage.
-    
-    Test results for "make -C genhtml_output/ SIZE=large":
-    
-    Original:
-      6 tests executed, 6 passed, 0 failed, 0 skipped (time 768.4s, mem
-      893.8MB)
-    
-    Patched:
-      6 tests executed, 6 passed, 0 failed, 0 skipped (time 202.3s, mem
-      908.10MB)
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 0f07133f184af6670bdf1edf39fca9d2e90e9ad2
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Fri Apr 7 14:38:22 2017 +0200
-
-    test: Add self-tests for genhtml
-    
-    Add some tests for checking basic functionality of genhtml.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 544a6951db25679792bb0648006a897ea564d883
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Fri Apr 7 14:32:47 2017 +0200
-
-    genhtml: Ensure stable block order in branch output
-    
-    Sort order of basic blocks in output of branch coverage data. This
-    allows for a better comparison of output between test cases.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 477957fa4c6c104d5842911682ec17d6ad2d2980
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Thu Apr 6 12:28:11 2017 +0200
-
-    lcov: Reduce load times for complex coverage data files
-    
-    lcov uses a significant amount of time loading coverage data files
-    containing complex branch coverage data (i.e. data with a large number
-    of branches per basic block). Most of this time is spent storing
-    branch coverage data in a vector-based data representation, with an
-    unnecessary amount of cross-checking being done for existing branch
-    data.
-    
-    Fix this by replacing the vector based data representation by two
-    separate representations, scalar for storage and hash for processing,
-    and by moving cross-checking out of the hot path. This results in a
-    significant speedup at the cost of a minor increase in memory usage.
-    
-    Test results for "make test SIZE=large":
-    
-    Original:
-      17 tests executed, 17 passed, 0 failed, 0 skipped (time 1883.9s, mem
-      2459.0MB)
-    
-    Patched:
-      17 tests executed, 17 passed, 0 failed, 0 skipped (time 283.6s, mem
-      2544.2MB)
-    
-    Note that this fix only applies to the lcov tool. The same work is
-    necessary for genhtml.
-    
-    This approach was inspired by a patch by creich.3141592@gmail.com.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 3b397a3f3acdb62080e8366130758cb34703cfbf
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Thu Apr 6 09:01:36 2017 +0200
-
-    test: Improve test framework
-    
-    Various improvements to lcov's self-test framework:
-     - Add test case for lcov --diff
-     - Add new verbosity level
-     - Enable normalization of coverage data files from stdin
-     - Fix lcov_add_concatenated4 test name
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 53a6ce8ef604173b6de874a534a30121392d7cd0
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Thu Mar 30 15:42:56 2017 +0200
-
-    lcov: Add self-tests
-    
-    Add some tests for checking basic functionality of lcov. To run these
-    tests, type:
-    
-    	make test
-    
-    in either the top-level directory, or the test/ sub-directory.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 9753d5c0da107919537e91e504551e4ab3bccc2f
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Thu Mar 30 15:31:34 2017 +0200
-
-    lcov: Fix output on stderr for --summary
-    
-    Some functions of lcov erroneously print informational output to stderr
-    instead of stdout as expected. Fix this by inverting the "to_file" logic
-    in lcov to a "data_stdout" logic. Affected functions are --summary,
-    --reset and --list.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 25f5d38abad20eeaa407f62f53c3c00dfbbd0bf3
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Mon Mar 6 09:51:00 2017 +0100
-
-    lcovrc.5: Add genhtml_demangle_cpp default and CLI reference
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 66db744a1d63c5d3b1dee2d8a2ce76e6e06c7255
-Author: Katsuhiko Nishimra <ktns.87@gmail.com>
-Date:   Fri Mar 3 17:47:48 2017 +0900
-
-    Support passing demangle-cpp option via lcovrc
-    
-    This patch allows users to passing the demangle-cpp option to genhtml
-    via lcovrc, alongside with CUI.
-    
-    Signed-off-by: Katsuhiko Nishimra <ktns.87@gmail.com>
-
-commit b6fb452addaa6a33dcb37c101879b8b5e1e0c34c (tag: v1.13)
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Mon Dec 19 15:20:40 2016 +0100
-
-    lcov: Finalize release 1.13
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit daca8d9febe52ccf1976240a3b48ffc350dec902
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Mon Dec 19 14:36:00 2016 +0100
-
-    geninfo: Fix 'unexpected end of file' error
-    
-    Use the compiler version as stored in the .gcno file to determine if
-    the file contains function records with split checksums. This fixes
-    the following problem that can occur when lcov is run using a gcov
-    tool of GCC version 4.7 and above on .gcno files compiled with a
-    version below 4.7:
-    
-      # lcov -c -d . -o test.info --initial
-      [...]
-      geninfo: ERROR: test.gcno: reached unexpected end of file
-    
-    Also add missing lcov version to --debug output.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit a90d50e97cb49ea712c94d91cdef1cc21a3c7986
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Wed Dec 14 11:00:08 2016 +0100
-
-    lcov: Remove use of install -D option
-    
-    Some versions of the install tool don't support the -D option, causing
-    a 'make install' call to fail. Fix this by replacing the -D option with
-    two calls to install, first to create all target directory components,
-    then to install the actual files.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-    Reported-by: <deanyang@tencent.com>
-
-commit 6ec3f2398d22e605c1a8019541fb32d26d18044b
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Fri Oct 7 09:47:35 2016 +0200
-
-    genhtml: Fix warning with small genhtml_line_field_width
-    
-    On systems with Perl versions 5.21 and above, genhtml prints a warning
-    similar to the following during processing:
-    
-      genhtml: Negative repeat count does nothing at bin/genhtml line 3854,
-               <SOURCE_HANDLE> line 4.
-    
-    This is due to size calculations resulting in a negative number of
-    padding characters when genhtml_line_field_width is lower than the size
-    of the strings to pad (9). Fix this by disabling padding in these cases.
-    
-    Reported-by: xaizek@openmailbox.org
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit d7cc7591b3a7cc1ec95371d04e4fc46f10b3fd54
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Tue Oct 4 09:50:52 2016 +0200
-
-    geninfo: Fix gcov version detection for XCode 8.0
-    
-    The LLVM gcov version included in XCode 8.0 reports its version in a
-    format that is not understood by geninfo, resulting in the wrong format
-    of coverage data files being expected. Fix this by reworking gcov
-    version detection in geninfo to be more robust.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 68320d932c5ee5537ae1c287fe52603ae2fecf8c
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Mon Aug 22 15:54:56 2016 +0200
-
-    lcov: Update installation mechanism
-    
-    Change default installation location to /usr/local to prevent
-    conflicts with files installed by package managers (reported by
-    Gregory Fong). To achieve this, rename PREFIX to DESTDIR and
-    introduce actual PREFIX Makefile variable and update spec file
-    to install packaged files to previous locations.
-    
-    Also fix spec file to not announce ownership of system directories
-    (reported by and based on patch by Jiri Kastner <jkastner@redhat.com>).
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 04a3c0ed1b4b9750b2ac5060aac0e6d5a3b9da7f
-Author: Benoit Belley <benoit.belley@autodesk.com>
-Date:   Mon Apr 4 18:16:54 2016 -0400
-
-    Pass --no-strip-underscore to c++filt on OS X
-    
-    * The --no-strip-underscope flag is necessary on OS X so that symbols
-      listed by gcov get demangled properly.
-    
-       From the c++filt man page: "On some systems, both the C and C++
-       compilers put an underscore in front of every name.  For example, the
-       C name "foo" gets the low-level name "_foo". This option tells c++filt
-       not to remove the initial underscore.  Whether c++filt removes the
-       underscore by default is target dependent."
-    
-    Signed-off-by: Benoit Belley <benoit.belley@autodesk.com>
-
-commit 632c25a0d1f5e4d2f4fd5b28ce7c8b86d388c91f
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Tue Mar 8 10:51:51 2016 +0100
-
-    lcov: Fix output files being created in / directory
-    
-    When a warning is emitted by lcov before creating an output file,
-    e.g. when a negative coverage count was found while combining
-    tracefiles, lcov tries to create the output file in the root
-    directory (/) instead of the current working directory.
-    
-    This is a result of lcov's warn handler calling a temp file cleanup
-    routine that changes directories to / before trying to remove its
-    temporary directory.
-    
-    Fix this by removing the temp cleanup call from the warn handler.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit e32aab1b4c85503a6592a91326c4b362613e1d66
-Author: Gabriel Laskar <gabriel@lse.epita.fr>
-Date:   Wed Feb 10 09:56:18 2016 +0100
-
-    lcov: Fix --remove pattern matching
-    
-    The --remove option of lcov now consider the pattern passed as parameter
-    as a full path, and not only a part of the filename.
-    
-    This behavior was discovered by using AX_CODE_COVERAGE[1] m4 macro from
-    a directory in $HOME/tmp. The macro itself calls lcov with
-    `--remove "/tmp/*"`.
-    
-    [1]: https://www.gnu.org/software/autoconf-archive/ax_code_coverage.html
-    
-    Signed-off-by: Gabriel Laskar <gabriel@lse.epita.fr>
-
-commit 79e9f281ea893b2f6498b4bad79173b1414aa055
-Author: Reiner Herrmann <reiner@reiner-h.de>
-Date:   Fri Oct 30 20:26:59 2015 +0100
-
-    lcov: use UTC to get timezone-independent date
-    
-    The date is used for updating the time inside manpages.
-    If localtime is used, the date could vary depending on the user's
-    timezone. To enable reproducible builds, UTC is used instead.
-    
-    Signed-off-by: Reiner Herrmann <reiner@reiner-h.de>
-
-commit de33f51b49dc6d01a285aa73990f03e7d982beb2 (tag: v1.12)
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Mon Oct 5 17:37:40 2015 +0200
-
-    lcov: Finalize release 1.12
-    
-     - Use full git describe output as tool version
-     - Update version numbers and last-changed-dates in man pages,
-       spec and README file
-     - Replace static CHANGES file with git log
-     - Switch Makefile logic to use mktemp for generating a temporary
-       directory
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 1ad4f7779b7721e311e552209e110e08bbf18fa1
-Author: Denis Abramov <abramov.denis@gmail.com>
-Date:   Mon Sep 21 09:29:20 2015 +0200
-
-    geninfo: Added support for Xcode 7.0 gcov version handling
-    
-    With Xcode 7.0 LLVM gcov keeps version information on the first line.
-    E.g. gcov --version yields: Apple LLVM 7.0.0 (clang-700.0.65)
-    
-    Signed-off-by: Denis Abramov <abramov.denis@gmail.com>
-
-commit c3602ea8e598deda4afff603bb123caa98eef159
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Mon Aug 3 11:05:51 2015 +0200
-
-    genhtml: Allow prefix paths with spaces
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit a3572971367198ef0febe476052640bd09bec931
-Author: Gilles Gouaillardet <gilles@rist.or.jp>
-Date:   Thu Jul 30 14:11:57 2015 +0900
-
-    genhtml: support a comma separated list of prefixes
-    
-    the --prefix option of genhtml now takes a comma separated list of prefixes
-    instead of a single prefix.
-    this can be required when running lcov vs projects configure'd with VPATH
-    and in which source files are both in the source and build directories.
-    
-    Signed-off-by: Gilles Gouaillardet <gilles@rist.or.jp>
-
-commit 997f32ae85717cd47d2305d7cd7ccce3ffa1abe6
-Author: Gilles Gouaillardet <gilles@rist.or.jp>
-Date:   Tue Jun 23 14:28:22 2015 +0900
-
-    Fix find command line
-    
-    find xxx -name \*.gcda -type f -o type l
-    does return :
-    - all files with the .gcda suffix
-    - all symbolic links
-    
-    the updated command line now returns
-    - all files with the .gcda suffix
-    - all symbolic links with the .gcda suffix
-    
-    Signed-off-by: Gilles Gouaillardet <gilles@rist.or.jp>
-
-commit 533db4e78b54ae01e023d00c1fec5dddaaaf37e6
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Wed Jun 17 17:54:20 2015 +0200
-
-    lcov: Fix capture for package files containing graph files
-    
-    Depending on whether package files contain graph files, data should be
-    collected from the unpacked package file directly, or from the build
-    directory after linking data files. This approach fixes problems when
-    capturing coverage data via a package from a directory containing graph
-    files.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit a2a8b376ec5e9e5082a0cbb935137d6a8f526870
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Wed Jun 17 17:34:33 2015 +0200
-
-    lcov: Fix .build_directory file not being deleted
-    
-    Using option --to-package while capturing coverage data creates a
-    temporary file named ".build_directory". Currently this file is not
-    properly removed at the end of processing due to a changed CWD. This
-    patch fixes this problem by reverting to the original CWD before trying
-    to remove the temporary file.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit b9de825f1fe018f381c8859ee0f3f4af15122c7a
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Tue Jun 16 13:53:00 2015 +0200
-
-    lcov: Enable userspace package capture with only data files
-    
-    Previously lcov's --from-package capture mechanism required
-    that .gcno files and source were present on the test machine.
-    
-    This patch modifies --from-package capturing to work when
-    only .gcda files are present in the package captured on the
-    test machine. It works by linking the .gcda files collected
-    on the test machine into their natural location on the build
-    machine. This requires existing .gcda files to be removed.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 0e4f0908aed3e1a071d5435c36c18cd493f0c309
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Tue Jun 16 13:33:54 2015 +0200
-
-    lcov: Make package handling more robust
-    
-    Apply some changes to --from-package and --to-package handling
-    to better handle failures:
-    
-     - Abort if tar tool is not available
-     - Abort if no data file is found in package file
-     - Ensure that temporary directories can be deleted
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit f87d980929a5a06d49d0a6856f6c3314418c27ef
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Tue May 12 17:28:44 2015 +0200
-
-    genhtml: Rework c++filt name demangling
-    
-    When running genhtml with command line option --demangle-cpp, do not
-    merge function call data based on demangled function names. Instead mark
-    duplicate function entries in the function view with a version suffix
-    (.<number>). This resolves problems with entries for functions that
-    demangle to the same name, but begin on different lines according to GCC
-    (e.g. virtual destructors).
-    
-    Reported-by: Lukasz Czajczyk <lukasz.czajczyk@gmail.com>
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 2e872175cbba2c09c9025da2660edf0b4abb55cb
-Author: Daniel Fahlgren <daniel@fahlgren.se>
-Date:   Wed Apr 22 15:17:10 2015 +0200
-
-    geninfo: make line exclusion markers configurable
-    
-    This patch exposes the variable $excl_line and $excl_br_line so they can
-    be set in the configuration file. It is not always possible to add the
-    exclusion markers to the code with reasons like third party code,
-    company policy, legacy code, no commit access etc.
-    
-    One obvious use case is to exclude assert() from the branch coverage and
-    abort() from line coverage. They are never meant to be triggered unless
-    something is wrong. Other use cases can be custom error handling macros
-    or macros that depend on endianness, like htons().
-    
-    Signed-off-by: Daniel Fahlgren <daniel@fahlgren.se>
-
-commit 10b11eaa178976d1433007adb2188d05b8605be6
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Mon Nov 10 17:17:23 2014 +0100
-
-    geninfo: Ignore empty .gcno files with --initial
-    
-    Some versions of GCC create empty .gcno files which cause geninfo
-    to abort processing with an error message:
-    
-      geninfo: ERROR: dummy.gcno: reached unexpected end of file
-    
-    Fix this problem by skipping empty .gcno files.
-    
-    Reported-by: Maarten Hoes <hoes.maarten@gmail.com>
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit f9d8079646aa906518c4ab7d326504e6837532a7
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Mon Nov 10 16:54:08 2014 +0100
-
-    lcov: Fix warning when specifying --rc
-    
-    Current Perl versions report the following warning when using the --rc
-    option of lcov:
-    
-      lcov: Use of each() on hash after insertion without resetting hash
-      iterator results in undefined behavior
-    
-    Fix this warning by not modifying the hash variable that is being
-    iterated on. Also add the missing whitespace fix-up of --rc parameters
-    to genhtml.
-    
-    Reported-by: Maarten Hoes <hoes.maarten@gmail.com>
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 2a634f6caa98f979606189ec3ee98f4cac270b97
-Author: Philip Withnall <philip.withnall@collabora.com>
-Date:   Mon Nov 10 14:58:34 2014 +0000
-
-    genhtml: Support relative source filenames in SF keys
-    
-    Some tools which generate .info files generate relative filenames for
-    the ‘SF’ keys. For example, nodeunit’s lcov output does. When genhtml is
-    run with --output-directory, it calls chdir() which breaks relative
-    lookup of the source files. Fix that by resolving all source filenames
-    to absolute paths when loading an info file, resolving any relative ones
-    using the info file’s path as a base.
-    
-    Signed-off-by: Philip Withnall <philip.withnall@collabora.co.uk>
-
-commit b4344c6a5d3c434ca0d801c197a09cfdeecb3f32
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Fri Sep 26 13:11:18 2014 +0200
-
-    man: Add description for --precision and genhtml_precision
-    
-    Add man page sections for genhtml's command-line option --precision
-    and lcovrc configuration setting genhtml_precision. Also add an
-    example configuration setting in lcovrc.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit aa1217412f1e8b540010fea5ca9844b9e4699e54
-Author: Euccas Chen <euchen@qti.qualcomm.com>
-Date:   Fri Sep 26 12:53:29 2014 +0200
-
-    genhtml: Implement option to specify coverage rate precision
-    
-    Add command line support and config file support for specifying the
-    coverage rate precision, valid precision range: [1,4].
-    
-    Signed-off-by: Euccas Chen <euchen@qti.qualcomm.com>
-
-commit 4d4eba1a8b5e7d2a6c5e93c0a50264da1a5c5540
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Wed Jun 25 09:41:59 2014 +0200
-
-    get_version.sh: Remove - characters from release string
-    
-    Replace - with . in release strings to fix the following build
-    error in the dist Makefile target:
-    
-      error: line 4: Illegal char '-' in: Release: 4-g1d44b2a
-      make: *** [rpms] Error 1
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit ffbd3e08cc0871842b2205b0b73c2ae8f3ad02e8
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Wed Jun 25 09:25:50 2014 +0200
-
-    genhtml: Improve demangle error message
-    
-    Improve error message that is shown when there are mangled function name
-    entries on different lines that demangle to the same clear text function
-    name.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 1d44b2a090aa933b15e4cafc1a440ccb390df92e
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Tue Jun 24 17:45:34 2014 +0200
-
-    geninfo: Fix error when using --demangle-cpp
-    
-    Using genhtml's --demangle-cpp option on data produced with recent GCC
-    versions (at least 4.8 and 4.9) can result in an error message similar
-    to the following:
-    
-      genhtml: ERROR: Demangled function name _ZN3subD2Ev  maps to different
-               lines (5 vs 4)
-    
-    The reason for this error is an unexpected sequence of lines records
-    in a .gcno file. These records mention line numbers as belonging to a
-    function which occur before the initial line number of that function
-    as reported by the corresponding function record.
-    
-    Fix this problem by retaining the order of lines belonging to a function
-    as found in the .gcno file. This way geninfo will consistently use the
-    initial line number as reported by the function record when merging
-    function data during the demangling process.
-    
-    Reported-by: Alexandre Duret-Lutz <adl@lrde.epita.fr>
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 566e5ec7e69a03612e1ed4961779d939af180d66
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Wed Jun 18 16:05:29 2014 +0200
-
-    lcov: Remove unused files
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit c76172bfe630520e217ecc0bca8f18481c4c33b0
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Wed Jun 18 16:01:05 2014 +0200
-
-    README: Fix typo
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit a6b10a41056cd10c7b735e259fee81f1865c2109
-Author: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-Date:   Wed Jun 18 15:50:04 2014 +0200
-
-    lcov: Remove CVS artifacts
-    
-    Replace CVS specifics in the build environment and tools source with
-    Git mechanisms:
-     * CONTRIBUTING and README file now refer to github for the primary
-       source location
-     * When run from a Git repository, the tools dynamically determine the
-       Git version using 'git describe'
-     * When installed into the file system, the version information is
-       fixed with the current Git version
-     * When preparing distribution files, the version at the time of
-       preparing the files is written to file ".version"
-    
-    Also add a .gitignore file to filter out the most frequent temporary
-    file types.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit fa2a991cf6fad37fec7650b95be705df143e058a (tag: v1.11)
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri May 23 08:56:17 2014 +0000
-
-    lcov: finalizing release 1.11
-
-commit e2729beea0d7769ef0e992c27a294b0742a6ac77
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri May 23 08:47:10 2014 +0000
-
-    CHANGES: update
-
-commit 866d187602bfc2e3a8199f4e9e9430ef38f106a8
-Author: Jeffrey Hutzelman <jhutz@cmu.edu>
-Date:   Tue May 20 14:12:55 2014 +0000
-
-    lcov: Sort branches in unnamed blocks first
-    
-    When processing branch coverage data, consider branches in "unnamed"
-    blocks to come before other blocks on the same line, so that they
-    appear in the correct order in HTML output.
-    
-    This is accomplished by using block number -1 for unnamed blocks,
-    instead of 9999 as was previously done.  In branch data vectors, this
-    is reprsented by the value $BR_VEC_MAX, which is defined to be the
-    largest value representable in the field width used.  This same value
-    is also used in .info files, for backward-compatibility with regular
-    expressions used to parse these files.  As a result, .info files
-    generated by versions of lcov with this change can be read by older
-    versions, though branch results will still appear out of order.
-    
-    Signed-off-by: Jeffrey Hutzelman <jhutz@cmu.edu>
-
-commit 17c0edec32193b9e8058908447d3eb403d76c8de
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu May 15 10:23:45 2014 +0000
-
-    lcov: Update man page
-    
-    Add missing description for command line parameter value.
-    
-    Reported-by: sylvestre@mozilla.com
-
-commit c0958139e015805cce15b60b740c735690ad4002
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Apr 14 12:14:55 2014 +0000
-
-    genhtml: Implement option to allow HTML in test description
-    
-    Add lcovrc directive genhtml_desc_html to allow using HTML markup in
-    test case description text.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 4f2c3aefcfcf816806da83a8609bd743eb227d37
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Apr 14 11:24:05 2014 +0000
-
-    genhtml: Check for proper description file format
-    
-    Ensure that description files contain test name lines before test
-    description lines. This fixes a "use of uninitialized value" warning
-    in genhtml.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 3a68239905c28a7c3bfac52172a254872d6a7aa7
-Author: Jonah Petri <jonah@petri.us>
-Date:   Mon Apr 14 11:06:21 2014 +0000
-
-    lcov: make geninfo compatible with LLVM's gcov
-    
-    These changes are needed to make geninfo compatible with LLVM's gcov:
-    * Use --version rather than -v to probe version info
-    * Convert LLVM gcov version numbers to the GCC gcov version they emulate
-    * Translate short options into their equivalent long option capabilities
-    
-    Signed-off-by: Jonah Petri <jonah@petri.us>
-
-commit a74bdeeae0383b197b1dafa44d01a54129fb3d7c
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 8 13:26:04 2014 +0000
-
-    genhtml: Reduce hash copying while adding up files
-    
-    Reduce copying effort and memory usage. Based on similar patch for
-    lcov by olly@survex.com.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit c6b4d91fdf667cfca17213742e2e04f6281ebed4
-Author: Olly Betts <olly@survex.com>
-Date:   Wed Jan 8 13:14:05 2014 +0000
-
-    lcov: Avoiding copying hashes passed to add_counts function
-    
-    This patch reduces memory usage - without it lcov was failing every time
-    for me with out of memory errors in a VM with 1GB of RAM and 1GB of
-    swap, but with it lcov completes every time.
-    
-    It's presumably also faster to avoid these copies.
-    
-    Signed-off-by: Olly Betts <olly@survex.com>
-
-commit cf6f2e685510da62bd2eb1f386f71d57c41f4594
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Dec 13 16:09:05 2013 +0000
-
-    geninfo: Tolerate garbage at end of gcno file
-    
-    Some versions of gcc produce garbage at the end of a gcno file
-    when recompiling a source code file after removing some lines.
-    
-    This patch makes geninfo's gcno file parser more robust by assuming
-    end-of-file when it finds a record that extends beyond the end-of-file.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 14286b29d076208452da6021c792ebf43552ac2c
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Dec 13 15:23:27 2013 +0000
-
-    geninfo: make gcov tool version detection more robust
-    
-    Don't consider gcov tool version information in parenthesis when
-    determining the gcov tool version. This fixes problems where the
-    version string contains a different version number in parenthesis
-    before the actual gcov version.
-    
-    Signed-off-by: Peter Oberparleiter <oberpar@linux.vnet.ibm.com>
-
-commit 0bde87338cd155af46804d77701c93ef263c3d53
-Author: Sebastian Stigler <s_stigler@gmx.de>
-Date:   Fri Dec 13 15:09:58 2013 +0000
-
-    geninfo: add exclude marker for branch coverage
-    
-    Sometimes it can be helpful to generally use branch coverage but to
-    disable it for some lines of code without excluding the line or function
-    coverage too.
-    
-    For example if you make heavily use of assertions in your code (which is
-    generally a good idea) you will see that for each 'assert(...)' exist
-    one branch which is taken and one that is not. Similarly you can see the
-    same phenomenon for 'delete' in C++ code.
-    
-    If you use the 'LCOV_EXCL_LINE' marker in such a situation both of these
-    branches will be omitted from the output. But in doing so, you loose the
-    ability to determine if this peace of code is genuine 'dead code' or not
-    because the line coverage is omitted too.
-    
-    The newly introduces 'LCOV_EXCL_BR_LINE', 'LCOV_EXCL_BR_START' and
-    'LCOV_EXCL_BR_STOP' marker address this problem. The usage is similar to
-    the 'LCOV_EXCL_LINE' etc. markers.
-    
-    Signed-off-by: Sebastian Stigler <s_stigler@gmx.de>
-
-commit 119be727596f567e83b03de384b4150b926911a3
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Dec 12 14:58:44 2013 +0000
-
-    geninfo: Fix handling of non-english locales
-    
-    geninfo expects gcov output in the default C locale. This isn't always
-    given, for example when running in an environment where variable
-    LANGUAGE is set to a non-english locale. In such cases gcov output
-    cannot be correctly parsed, resulting for example in the absence of
-    branch coverage data.
-    
-    gcov uses gettext() for writing internationalized messages. The info
-    page for gettext mentions the order in which locale-defining
-    environment variables are evaluated:
-    
-    LANGUAGE
-    LC_ALL
-    LC_MESSAGES
-    LANG
-    
-    In addition, gettext implements special handling where LC_ALL=C takes
-    precedence over LANGUAGE.
-    
-    geninfo currently only specifies LANG=C. Fix the issue by specifying
-    LC_ALL=C instead.
-    
-    Based on fix suggestion by Sebastian Stigler.
-    
-    Reported-by: Sebastian Stigler <s_stigler@gmx.de>
-
-commit 0f7bb3ebc8487b83ce9b7047c81a3655135876ea
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Dec 9 15:49:35 2013 +0000
-
-    lcov: Added contribution guidelines
-
-commit f83688fe27f133ef02e9ab47a435d6a5d2074932
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 2 07:29:20 2013 +0000
-
-    geninfo: fix --no-external not working with --initial
-    
-    When running lcov --capture --initial together with --no-external.
-    the --no-external has no effect. Fix this by applying the external
-    filtering also for graph files.
-    
-    Reported-by: malcolm.parsons@gmail.com
-
-commit 6a8a678046bd75aa81d30484b1817425022d71e5
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jul 1 11:49:46 2013 +0000
-
-    lcov: fix --config-file not being passed to geninfo
-    
-    Calling lcov to capture coverage data while specifying --config-file
-    will result in the configuration directives of that file not being
-    used during data collection.
-    
-    Fix this by ensuring that --config-file is passed on to geninfo.
-    
-    Reported-by: liuyhlinux@gmail.com
-
-commit c3be5b6859ef280b469b6b75cf4709fc35f91ced
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu May 2 11:02:24 2013 +0000
-
-    lcov: fix whitespace handling in --rc command line option
-    
-    Specifying blanks around --rc options results in the options not
-    being correctly recognized, for example:
-    
-    This doesn't work:
-    geninfo . -o - --rc="geninfo_adjust_src_path = /tmp => /usr"
-    
-    This works:
-    geninfo . -o - --rc="geninfo_adjust_src_path=/tmp => /usr"
-    
-    Fix this by automatically removing whitespaces at the start and end
-    of --rc options and values.
-
-commit 4699f8d391325335777ed234e388be2e2f87478c
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Apr 12 07:51:34 2013 +0000
-
-    README: improve usage hint
-
-commit 36e0539737198ad1bee51103f47842f13c575239
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Mar 13 10:28:07 2013 +0000
-
-    genhtml: add time to date string
-    
-    Add the current time to the date information in the HTML output
-    generated by genhtml. This way users can differentiate results when
-    creating HTML output multiple times a day.
-    
-    Based on patch by sylvestre@debian.org.
-
-commit 38fbe93c8cd8402be8e4821825fdeeaa23e8367c
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Feb 22 14:09:08 2013 +0000
-
-    geninfo: don't warn about missing .gcov files
-    
-    Newer versions of gcc remove .gcov files for source files that do
-    not contribute instrumented lines. Remove the
-    
-      WARNING: no data found for file.c
-    
-    warning that geninfo issues in this case.
-
-commit 29346542c30af221a2ffdfe097fbd858044b712a
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Feb 1 11:44:03 2013 +0000
-
-    genhtml: fix handling of user-specified prefixes with trailing /
-    
-    A trailing / in a user-specified prefix is not correctly recognized.
-    Fix this by removing any number of trailing / in a user-specified
-    prefix. Reported by ahmed_osman@mentor.com.
-
-commit 5241e2afadca5f172bd0b8cafe61e20d2153f0bf
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 30 11:46:42 2013 +0000
-
-    lcov: fix bug when converting function data in --diff operation
-    
-    When a patch is applied to a tracefile using command line option --diff
-    and the patch changes the list of functions, the operation aborts with
-    the following error:
-    
-      lcov: Use of freed value in iteration at lcov line 3718.
-    
-    Fix by applying missing calls to keys() when iterating function data
-    hashes. Reported by Nasir.Amanullah@us.fujitsu.com.
-
-commit 9ce8d8cb4f978eb80fb88ecafd52e869fab75d8f
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 25 16:30:25 2013 +0000
-
-    lcov/genhtml: fix outdated comment regarding data structure
-
-commit c85e73a36e3f8c4e7fab888ac1536bee94a6fe56
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 25 16:29:30 2013 +0000
-
-    genhtml: merge function data during demangling
-    
-    Merge function execution counts when multiple function names demangle
-    to the same name.
-
-commit 2dfafc99c1eccbb81066436845e06a868eb3c434
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 25 11:46:28 2013 +0000
-
-    genhtml: improve function table sorting
-    
-    In the function table view, the initial view should show the functions
-    sorted by execution count because - unlike with file names - the function
-    name is not a natural order for functions (the line number would be,
-    but that is not available). Also sort functions with the same execution
-    count alphabetically for a stable order.
-    
-    Base on a suggestion by paul.bignier@hotmail.fr.
-
-commit 331a29011709a27d2ec11c6cbd6ac51dfdaf70c6
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 23 16:52:06 2013 +0000
-
-    genhtml: consolidate calls to c++filt
-    
-    When using --demanglecpp, call c++filt only once instead of per
-    function. This approach can reduce the run-time for source files
-    with a lot of overloaded functions significantly. Based on idea
-    by olly@survex.com.
-
-commit 49b877160b1d28cd6c3d8332d5d47c9c74420070
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Jan 10 09:02:32 2013 +0000
-
-    geninfo: make empty data directories non-fatal
-    
-    Emit a warning when no data file is found in a data directory
-    to allow processing of additional directories.
-    
-    Based on suggestion by rich_drake@yahoo.com.
-
-commit 3836c162c2864ed180df7d80fa03c70d17102edc
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Nov 13 09:58:53 2012 +0000
-
-    geninfo: fix parsing of gcc 4.7 gcov format
-    
-    GCC 4.7 changes the gcov format for lines which can only be reached
-    by exceptions to "=====" instead of "#####". This results in the
-    following warning:
-    
-    geninfo: Argument "=====" isn't numeric in numeric gt (>) at geninfo
-    line 1281.
-    
-    Fix this by handling "=====" correctly.
-
-commit b932f94cc83c3df169c76689533336bba4de4dba
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Oct 10 09:14:17 2012 +0000
-
-    lcov.spec: back to CVS version
-
-commit 6af00fa26e1a91a39c873ff9fa6df7fb8830ec42
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Oct 10 09:12:42 2012 +0000
-
-    lcov.spec: fix Perl dependency
-
-commit 4eac16e93db328e86e44da40e3d5e96a0301d361
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Oct 10 08:36:16 2012 +0000
-
-    lcov: update CVS version to 1.11-pre1
-
-commit b5c1bdddd1380be3ad12952ed2747df3744e227e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Oct 10 08:20:21 2012 +0000
-
-    lcov: finalizing release 1.10
-
-commit 089861768a94d0f6e827539c828f19141092f529
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Oct 10 08:07:54 2012 +0000
-
-    CHANGES: update
-
-commit 9037de17458c5d9767d201bd0599d40347a9bc41
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Oct 10 08:07:01 2012 +0000
-
-    genhtml: handle source files in root directory gracefully
-
-commit 68dd0f19da0d8d6e82375e09b97f7ffc22847db4
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Oct 9 13:58:22 2012 +0000
-
-    geninfo: add automatic detection of base directory
-    
-    Add a heuristic to automatically determine the base directory
-    when collecting coverage data. This heuristic should cover many,
-    if not most cases of build systems moving files around during
-    compilation (e.g. libtool, automake, etc.). The heuristic can be
-    enabled or disabled using the configuration file directory
-    'geninfo_auto_base'.
-
-commit 631d2b11bfde56ffca4568382abf5d90653c4141
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Oct 8 15:03:23 2012 +0000
-
-    geninfo: fix missing line data after last commit
-
-commit b1e14c4a1a0f3ccaad0c665f439624cf4588a68d
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Oct 8 13:02:45 2012 +0000
-
-    lcov: add missing help text for option --rc
-
-commit a432efff6ee8485ec0724aca4eae79a4c390a328
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Oct 5 15:53:09 2012 +0000
-
-    lcov: updated CHANGES file and copyright years
-
-commit 897322ecdb858f18e4a12f4716bbb08c067b6c9c
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Oct 5 15:20:41 2012 +0000
-
-    geninfo: fix warning about unhandled .gcov files
-    
-    gcov will sometimes create .gcov files that contain no instrumented
-    line. When geninfo reads .gcno files it filters out such files,
-    resulting in the following warning:
-    
-    geninfo: WARNING: cannot find an entry for #path#to#file.gcov in
-             .gcno file, skipping file!
-    
-    Avoid this warning by not filtering out non-instrumented lines.
-
-commit 37d381ae99a66f59ea55d966f1da13a726d2efe8
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Oct 5 15:09:58 2012 +0000
-
-    genhtml: fix source path prefix calculation
-    
-    Fix the following problems of the algorithm used to identify an
-    optimal source path prefix:
-    - the last two path components (filename and first parent
-      directory) are ignored when trying to identify the optimal
-      prefix
-    - if a path prefix matches a longer path prefix, the weight
-      of the filenames associated with the latter is incorrectly
-      attributed to the former
-
-commit 263de2b40e21193ef8d11e899eb55aa52b17225d
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Oct 5 12:00:57 2012 +0000
-
-    lcov: set default for branch coverage data to disabled
-    
-    Collecting branch coverage data can significantly slow down
-    coverage data collection and processing of data files. Assuming
-    that most users are more interested in line/function coverage,
-    change defaults to not collect/process branch coverage data.
-    
-    Users can still override this default using lcov_branch_coverage=1
-    in the lcovrc file or command line option --rc lcov_branch_coverage=1
-
-commit 7e04a152683ff66e24b87f2125474c6765d4524b
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Oct 5 11:49:30 2012 +0000
-
-    geninfo: fix problems with adjust_src_path option
-    
-    Fix the following problems with adjust_src_path:
-    
-     * specifying --compat libtool=on and geninfo_adjust_src_path
-       unexpectedly sets --compat libtool=off
-     * path components that are assembled from sub-directory names are
-       not correctly adjusted
-
-commit 74e4296b6e2a0b0f164c6828c28cc82449344f08
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Oct 5 08:23:06 2012 +0000
-
-    lcov: add setting to disable function and branch coverage
-    
-    Add two new configuration file settings:
-    
-     * lcov_function_coverage and
-     * lcov_branch_coverage
-    
-    When set to zero, lcov will skip the corresponding coverage data
-    type from being collected or processed, resulting in reduced
-    memory and CPU time consumption and smaller data files.
-
-commit 37bc1a1a5f721c6b88fff4c63121c1cbb794c14f
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Oct 2 14:29:57 2012 +0000
-
-    lcovrc: clarify meaning of geninfo_external in man page
-
-commit fc4b9e21efe8f3409d9b0b90cfe7a3e8bc59a74c
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Oct 2 09:12:38 2012 +0000
-
-    geninfo: fix processing of pre-3.3 gcov files
-    
-    When trying to collect coverage data for programs compiled with
-    GCC versions prior to 3.3, geninfo skips each data file with the
-    following warning:
-    
-    geninfo: WARNING: cannot find an entry for test.c.gcov in .bb file,
-    skipping file!
-    
-    Fix this by deriving the source code filename from the gcov filename
-    in case the gcov files do not follow the GCC 3.3 format.
-    
-    Reported-by: georgysebastian@gmail.com
-
-commit d1014dfcabfee2f305278a14ec8e5343e3889139
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 24 11:43:18 2012 +0000
-
-    lcov: fix problems with --rc option
-    
-    Fix error "Invalid option linkage for \"rc=s%\"" when running lcov
-    with an older version of the Getopt::Long module. Also pass --rc
-    options through lcov to geninfo.
-
-commit a9f08b79e2e7ec2b4a5c9ad27a077df8dfb46890
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Jul 24 15:41:38 2012 +0000
-
-    geninfo: implement rc option geninfo_adjust_src_path
-    
-    Provide a new lcovrc file option geninfo_adjust_src_path that users
-    can use to change incorrect source paths.
-    
-    Inspired by patch by ammon.riley@gmail.com.
-
-commit 108f805788590defda99fdf252bfb71cb749f31e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Jul 19 13:12:35 2012 +0000
-
-    lcov: implement command line option --rc
-    
-    Users can now use command line option --rc to override configuration
-    file directives.
-
-commit eeeeeca74706e88a9b8ecfef2bb3451957512e20
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 18 12:56:21 2012 +0000
-
-    lcovrc: add description for geninfo_compat setting
-
-commit f842e46149b48ff316e80f68f630bf94085e4d19
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 18 12:40:56 2012 +0000
-
-    lcov: improve --compat description
-
-commit 392a690ba31092857f7d21d0008783d87954ebce
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 18 12:13:00 2012 +0000
-
-    lcov: add missing documentation for --compat option
-    
-    Add missing sections in the geninfo and lcov man-pages for the
-    newly introduced command line option --compat. Also set the
-    default value for the hammer compatibility mode to 'auto' to
-    keep the behavior of previous releases.
-
-commit 691cab3e3aaebc295c2cfe91c43c6a7c48f1ec2b
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 18 10:40:12 2012 +0000
-
-    lcov: fix extra closing parenthesis in comment
-
-commit cef6f0ff8baa9b2b3dfb437463e7a88d3380b555
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Jul 17 11:37:13 2012 +0000
-
-    lcov: make 0%/100% exclusive to no/full coverage rate
-    
-    Ensure that coverage rates 0% and 100% are only used when no or all
-    lines/functions/branches are hit respectively. This approach is
-    implemented to allow better identification of boundary cases, and
-    to be in accordance with the behavior of the gcov tool.
-    
-    Based on suggestions by: Paul.Zimmermann@loria.fr and
-    vincent@vinc17.net
-
-commit 9cec8f7e332258c9128f1c53d61acb9f0bc17085
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 11 14:09:27 2012 +0000
-
-    geninfo: more improvements to the .gcno format auto-detection
-    
-    Suggestions by garnold@google.com:
-    - rename command line setting
-    - simplify logic
-
-commit 0bbca3bd0c1ad3e3d3fd0b6eebfc3afbbc212a85
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jul 6 14:29:27 2012 +0000
-
-    geninfo: rename compatibility setting to compatibility mode
-
-commit f30fb978662996e29517c733218292a91f5fd12b
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jul 6 09:03:27 2012 +0000
-
-    geninfo: improve detection of gcc 4.7 function records
-    
-    Suggestions by garnold@google.com:
-    - perform detection only once
-    - add warning in case detection is off but overlong strings are found
-    
-    Misc:
-    - add help text for --compat
-    - isolate detection heuristic into separate function
-    - rename corresponding compatibility setting to "gcc_4_7"
-    - allow "android_4_4_0" as alias for "gcc_4_7"
-
-commit 01321c3f170e5d24ffb3bb998441c99f5b775836
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 4 16:06:10 2012 +0000
-
-    geninfo: enable auto-detection of gcc-4.7 function record format
-    
-    gcc-4.7 introduced a modified function record format. This format
-    is in use by android toolchains and has also been ported to some
-    pre-4.7 versions of gcc. Introduce a heuristic-based auto-detection
-    to correctly handle .gcno files in these cases.
-
-commit d929600a0e2133168085e5ddea7ee832afd902b7
-Author: Martin Hopfeld <martin.hopfeld@sse-erfurt.de>
-Date:   Fri Jun 8 14:19:49 2012 +0000
-
-    geninfo: Make geninfo work more reliably on MSYS
-    
-    Using the lcov tools on Win7 with MSYS and MinGW 4.5.1/4.5.2
-    raised some issues for us:
-    
-    geninfo created in the for one source file in the 'SF:' line
-    paths starting with a lowercase drive letter and sometimes
-    starting with uppercase drive letters.
-    
-    This lead to inaccurate coverage results on the MSYS platform.
-    
-    This patch fixes this issue.
-
-commit 5b2751854aa19e6443fdc5fecc139595988d1e99
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon May 7 16:04:49 2012 +0000
-
-    lcov: add perl version dependency to RPM spec file
-    
-    lcov CVS (1.10 pre) seems to be broken on MSYS with perl 5.6.1.
-    The issue is the following:
-    
-      genhtml: Unknown open() mode '>>&' at /usr/bin/genhtml line 5512.
-    
-      $> perl genhtml --version
-      genhtml: LCOV version 1.10 pre (CVS 1.58)
-    
-      $> perl --version
-      This is perl, v5.6.1 built for msys
-    
-    Fortunately perl v5.8.8 is available for MSYS and genhtml works like a
-    charm with that 'new' version.
-    
-    Reported-by: Martin Hopfeld <martin.hopfeld@sse-erfurt.de>
-
-commit 83957a145d243cad0f8060e4a9ccc6cb8ed8fc09
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Apr 10 11:48:52 2012 +0000
-
-    geninfo: add support for gcc 4.7 .gcno file format
-    
-    Based on patch by berrange@redhat.com.
-
-commit 91c91dbc63d1e880d106919300c2fb37737697b0
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 20 11:53:57 2012 +0000
-
-    lcov: add new command line option --compat
-    
-    Add new option to lcov and geninfo to specify compatibility settings.
-    
-    Supported settings:
-      libtool: same as --compat-libtool
-      hammer: gcc3.3 hammer patch compatibility
-      android_4_4_0: android toolchain 4_4_0 compatibility
-
-commit 9588355790a302da680eff2f664058f78439a03e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Aug 11 08:29:21 2011 +0000
-
-    lcov: fix problem with Objective-C functions
-    
-    Fix geninfo not recognizing function entries for Objective-C functions.
-    
-    Based on patch by abrahamh@web.de:
-    current version of lcov unfortunately not support Objective-C files.
-    In details the count of tested function is zero always and the annotated
-    lines have an offset by one if the Objective-C method have one ore more
-    arguments.
-
-commit e1acd78d1e88fe51aad96badf32555c470ee029b
-Author: Martin Hopfeld <martin.hopfeld@sse-erfurt.de>
-Date:   Mon May 23 08:03:13 2011 +0000
-
-    geninfo: Make geninfo handle MinGW output on MSYS.
-    
-    This patch converts path mixtures from MinGW when running on MSYS to
-    correct MSYS paths.
-    
-    In solve_relative_path() an additional conversion step will be inserted
-    when running on MSYS. This will extract the drive letter and convert the
-    remaining path from Windows pathnames to Unix Paths, which are used by
-    MSYS.
-    
-    Additionally, if no drive letter is found, the (relative) path is
-    converted to Unix style. There may be the case where Windows and Unix
-    path separators are intermixed within one path string.
-
-commit ed161e3db5cd5a7c6c8b2113930c729f001cdd4e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Dec 16 08:11:22 2010 +0000
-
-    genpng: handle empty source files
-    
-    Generating an overview PNG image for an empty source code file fails.
-    Handle this case by assuming a single empty line when run for an empty
-    source code file.
-    
-    Reported by: sylvestre@debian.org
-
-commit 95e2c5c337d281b4e88144d95d29bbec183c8728
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Dec 7 08:40:09 2010 +0000
-
-    genhtml: add note to further explain branch coverage output
-
-commit b1c66916151dd4b20998c79f81edf174659ebb14
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Dec 7 08:29:45 2010 +0000
-
-    genhtml: fixed incorrect description of default coverage rates
-
-commit 1994be7d8ed472772b884063af74235f2f25ab39
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Nov 19 16:33:25 2010 +0000
-
-    geninfo: add missing man page sections
-    
-    Add sections describing options --derive-func-data and --no-markers to
-    the geninfo man page.
-
-commit 01a393ef76092e43ebd2d8bf7892ebf375481a84
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Nov 19 16:15:27 2010 +0000
-
-    geninfo: remove help text for unimplemented parameter
-    
-    Parameter --function-coverage was removed but the help text still
-    mentions it. Fix this by removing the option from the help text as
-    well.
-
-commit b92f99d9db0af131080c462300dc9baf292a8ff6
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Nov 19 16:00:22 2010 +0000
-
-    genhtml: handle special characters in file and directory names
-    
-    HTML special characters (e.g. '<') found in file or directory names are
-    not correctly shown in HTML output. Fix this by correctly escaping such
-    characters.
-
-commit 17e158d4569d25218e79901e2d8cd03bfc7752fc
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Nov 19 15:45:01 2010 +0000
-
-    gendesc/genhtml/geninfo/genpng/lcov: handle '<' in filenames
-    
-    Use 3-arg open mode to prevent that a special character (e.g. '<')
-    found in a user-specified filename interfers with the required open
-    mode for that file.
-
-commit b87e40e475c560bdc88206df4de6dc8cf094d91f
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Nov 19 15:11:53 2010 +0000
-
-    geninfo: ignore <built-in>.gcov files
-    
-    The gcov tool will sometimes create a file <built-in>.gcov for code
-    which was added by gcc itself during compilation. Since there isn't
-    any source available for such code, geninfo will fail. Fix this
-    by skipping these files while capturing code coverage data.
-
-commit 398d8f385423927b5675c1429f58c67b6a89a1a8
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Oct 28 14:17:57 2010 +0000
-
-    geninfo: add function comment
-    
-    Add comment explaining data structures used by function derive_data.
-
-commit f5c2072e0e7195d35455db50705884e7f6c5fbe5
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Oct 28 14:16:34 2010 +0000
-
-    geninfo: apply exclusion marker to derived function data
-    
-    When option --derive-func-data is used together with exclusion markers,
-    function data for excluded lines is still included. Fix this by
-    only deriving function data for lines which are instrumented and not
-    excluded.
-    
-    Reported by: bettse@gmail.com
-
-commit 82280b8a5a78e8a147c333c8850a556729d9d96d
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Aug 31 08:19:03 2010 +0000
-
-    geninfo: improve --debug output
-
-commit 6375a03010cb1bb22490b9d19a176188940e2f8b
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Aug 31 08:17:23 2010 +0000
-
-    gcov: add configuration file option to not use gcov's -a option
-    
-    lcov calls gcov while specifying its --all-blocks option to get more
-    detailed branch coverage data per line. It turns out that this option
-    is broken on many versions of gcov, resulting in an endless loop while
-    processing some gcov data files. There's also a slight performance
-    penalty when specifying -a.
-    
-    lcov users can opt to not use the -a option by setting configuration
-    option geninfo_gcov_all_blocks to 0 in the lcovrc file.
-
-commit 7706fb73ebef8060fbbd92c0e08b5d68a2cd284e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Aug 24 16:15:53 2010 +0000
-
-    lcov: add option to specify a configuration file
-    
-    Provide an option for users to specify a configuration file to lcov.
-    This option may be useful when there is a need to run several instances
-    of a tool with different configuration file options in parallel.
-
-commit a404dafc2da12608a936afeb095d68410fa49b0a
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Aug 23 16:14:37 2010 +0000
-
-    lcov: add option to display summary coverage information
-    
-    Provide an option for users to determine the summary coverage
-    information of one or more tracefiles. Example output:
-    
-    Summary coverage rate:
-      lines......: 26.0% (78132 of 300355 lines)
-      functions..: 34.9% (8413 of 24081 functions)
-      branches...: 16.9% (32610 of 193495 branches)
-
-commit 526b5b6a43f2b29f11eb02c1dd8f645293d8c295
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Aug 23 14:47:43 2010 +0000
-
-    lcov: add option to exclude external files
-    
-    Implement an option for users to specify that external source files
-    should be excluded when capturing coverage data. External source files
-    are files which are not located in the directories specified by the
-    --directory and --base-directory options of lcov/geninfo.
-
-commit c2255a0344648dc6eaef0189c53f345fdc70ed4e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 20 14:58:48 2010 +0000
-
-    lcov: pass --no-recursion to geninfo
-    
-    When specifying --no-recursion, make sure that the option is also passed
-    to the helper tool geninfo.
-
-commit 83543f3d21b5a5496b57c8d73e8e9c1819f82f34
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 20 14:31:59 2010 +0000
-
-    genhtml: fix HTML page title for directory pages
-
-commit b77df8ef1a69de3809e0b0bfa5cbbe5a84f313ae
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 20 14:27:19 2010 +0000
-
-    genhtml: make HTML charset specification customizable
-    
-    Provide a configuration file setting to adjust the charset specification
-    used by all generated HTML pages. Also change the default charset to
-    UTF-8.
-
-commit 1ff260462a67c440dc709d34c1fadf7d64760120
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 20 13:14:50 2010 +0000
-
-    lcov: follow Perl naming guidelines
-
-commit f637eb8c6ecb793b64eeb6bea57c6be8501d1484
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 20 13:08:25 2010 +0000
-
-    genhtml: add --ignore-errors option
-    
-    Provide a means for users to specify that genhtml should not abort if
-    it cannot read a source code file. Also make handling of --ignore-errors
-    parameter consistent accross lcov, geninfo and genhtml.
-
-commit 617bced393d5bb97e3409ec140768d9c8a2e2bfb
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 6 11:25:12 2010 +0000
-
-    lcov: update CVS version to 1.10
-
-commit 4dcb4f0ed014ca0f49859ef84fc9ced650f6deb8
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 6 11:14:38 2010 +0000
-
-    lcov: finalizing release 1.9
-
-commit 594779e047eed2f534905ac40912969955d3797f
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Aug 5 16:17:44 2010 +0000
-
-    lcov: update CHANGES file in preparation of new release
-
-commit fbbd9034e7a4ea4bc59342b22bfbe9612dd4bdb8
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Aug 5 15:11:56 2010 +0000
-
-    lcov: introduce configuration file parameters for list output
-    
-    Make some aspects of list output customizable via configuration
-    file parameters. Also introduce special handling, if the root
-    directory is chosen as prefix.
-
-commit c6e783c1a1d3fb6db7419af95f9e2dcb89836fe9
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Aug 5 14:07:35 2010 +0000
-
-    lcov: switch coverage rate and number columns in list view
-    
-    To be more consistent with the order of output in the "Overall
-    coverage rate" case, rates are now shown first in the list output.
-
-commit 3c87b66c68c2e06811c9be479c6813cb409e5461
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Aug 5 11:22:12 2010 +0000
-
-    lcov: fix display of total line coverage rate in list view
-
-commit 3cb6bc4ae0ef34aa63931d63f659f1ef43804c77
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Aug 4 16:15:19 2010 +0000
-
-    lcov: more lcov --list improvement
-    
-    Further improve list output to increase readability.
-
-commit dd98ff68ad143b985a728fc585c86d69e6027bd8
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 28 14:49:47 2010 +0000
-
-    lcov: minor list improvement
-
-commit d4778c75ce8cf3c9d44607b6fd0e385db71126dd
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 28 14:48:25 2010 +0000
-
-    geninfo: remove unneeded functions
-
-commit 65a15afef3430c49c9c7c0d151cc2afec5fc83cc
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 28 14:19:09 2010 +0000
-
-    geninfo: print note on branch coverage data only once
-
-commit bd8ab633298ec27acf5f7db4b2cc4766baf1f153
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 28 14:17:59 2010 +0000
-
-    geninfo: remove incorrect overall coverage rate calculation
-    
-    geninfo output showing the overall coverage rate of its current
-    operation is incorrect since it may count lines, functions and
-    branches for included files multiple times. Remove the output
-    and associated code until a fixed version is available.
-
-commit 8c54de96a1326b7ee0632773816c52eda43393e8
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 28 13:56:26 2010 +0000
-
-    lcov: more list output fixes
-
-commit 7e5fa9900d991320677c381db747c764495b2cc2
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 28 13:52:01 2010 +0000
-
-    lcov: fix list output
-    
-    Fix list output for directories with short filenames.
-
-commit badd4790c70bd8ef8b991a9d56d0e062b28006a8
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jul 26 13:33:18 2010 +0000
-
-    lcov: fix problem when using --initial and --kernel-directory
-    
-    Fix a problem in lcov that resulted in --kernel-directory options
-    being ignored when specifying --initial at the same time.
-    
-    Reported by hjia@redhat.com.
-
-commit a06c2038babb2f6d3e0a634cd298b0434041f834
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jul 19 16:06:15 2010 +0000
-
-    genhtml: change wording for branches which were not executed
-    
-    Since gcov sometimes reports both branches which were never executed
-    as well as branches which were executed in a single block, the wording
-    of the HTML alt text needs to be adjusted accordingly.
-
-commit e6b2491823ffd84c85406145031646af675170ee
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jul 19 15:50:02 2010 +0000
-
-    geninfo: handle branches in unnamed blocks
-    
-    gcov will sometimes report branches outside of a block. In that case,
-    account these branches to a special block so that they are not
-    accidentally merged with subsequently reported blocks.
-
-commit d6c82edf2117ce8b6232c998baf06c7a87269081
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jul 19 15:23:10 2010 +0000
-
-    genhtml: fix branch formatting code
-    
-    Fix the vertical alignment of the HTML representation of branches in
-    the source code view.
-
-commit 44ac74a47e25064ad1b421f65a28d057fdb9925d
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jul 19 14:27:08 2010 +0000
-
-    lcov: improve list output
-    
-    Improve list output by separating directory and file names. Also provide
-    an option to show full path names.
-
-commit 0ab6f7507f3c4f074bec41e571ff1afbeb943185
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jul 19 12:12:43 2010 +0000
-
-    genhtml: fix large numbers being shown as negative in html output
-    
-    genhtml uses a "%d" format string for printing execution counts. For
-    counts exceeding integer range, the output becomes negative. Fix this
-    by using the "%.0f" format string instead.
-    
-    Reported by kkyriako@yahoo.com.
-
-commit bbf0ef40a51dd716c544f91576cffde7986bb6ec
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jun 7 12:22:18 2010 +0000
-
-    geninfo: ensure that exclusion markers apply to --initial
-    
-    Fix a problem where exclusion markers are ignored when gathering
-    initial coverage data.
-    
-    Problem was reported by ahmed_osman@mentor.com.
-
-commit b371fc59fa52f7176f62f382457fba498f39f4b2
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Jun 1 13:48:29 2010 +0000
-
-    lcov: fix problem with relative path names
-    
-    Fix a problem where coverage data is missing because gcov produces
-    output files starting with a dot.
-    
-    Problem reported by weston_schmidt@open-roadster.com.
-
-commit 93c70ddd0edbc2b0addf9d135dfd76871cc7a160
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Sun Feb 28 20:57:37 2010 +0000
-
-    lcov: fix problem with relative paths in build paths
-    
-    When binaries are built using relative paths, lcov cannot find any
-    coverage data. Instead, warnings similar to the following are printed:
-    
-    geninfo: WARNING: cannot find an entry for ^#src#test.c.gcov in .gcno
-    file, skipping file!
-    
-    The reason for this is that File::Spec::rel2abs does not remove ../ from
-    paths which results in lcov not being able to match the relative and
-    absolute versions of the corresponding filenames. Fix this by using the
-    internal function solve_relative_path instead.
-
-commit fad24a75cc69364d002d40e4fb75736b0efbdb37
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Sun Feb 21 14:57:52 2010 +0000
-
-    geninfo: write all debugging output to STDERR
-
-commit c0943385fa0acb927f63f9f78c9aeaebe3a8ece1
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Sun Feb 21 14:56:46 2010 +0000
-
-    geninfo: fix problem with some .gcno files
-    
-    Some .gcno files contain more data in a line record than
-    expected. Skip unhandled bytes of a .gcno file record.
-    This prevents the following unexpected error message:
-    
-    geninfo: ERROR: file.gcno: reached unexpected end of file
-
-commit 4b9ee7598e991b503425148eb43a35de2702aded
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Sun Feb 7 13:07:09 2010 +0000
-
-    lcov: add COPYING file
-
-commit de0e43a098ade45d6624ea43a53e6fad9a176469
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 29 11:07:25 2010 +0000
-
-    lcov: update CVS version to 1.9
-
-commit 4a33269fa3a73ea2577f7616d90bd3f1d14ae460
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 29 10:09:53 2010 +0000
-
-    lcov: finalizing release 1.8
-
-commit 310ffb28d8847f96e02b5a5db3d16bdcb406a876
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 29 10:01:35 2010 +0000
-
-    lcov: updated CHANGES file
-
-commit 9e12808e6108e05dca42b5e682bd8be121f3608d
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 29 09:21:22 2010 +0000
-
-    genhtml: use sans-serif font for function table
-
-commit 71baabb6a1c15228213f8b25359346ee202300ce
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 29 09:12:55 2010 +0000
-
-    lcov: improve list output
-
-commit cc61a28dbc3c46ac84340141fafbfa559e1bf318
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 29 08:56:19 2010 +0000
-
-    lcov: fix overall rate display for tracefiles with more than one testcase
-
-commit b89028529db5110b3b76d117df788768a593d7dd
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 29 08:44:47 2010 +0000
-
-    lcov/genhtml: fix warning while merging branch data
-
-commit b7c69f31d9b1bfbd4bfc0fcb880cb8e514bcdb3f
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Jan 28 15:59:23 2010 +0000
-
-    lcov: fix branch coverage related issues
-    
-    - warnings when combining certain combinations of branch data
-    - branches are not merged correctly when multiple input files are specified
-      to genhtml or when lcov -a is used
-
-commit 817875459df122fa3536a5e57c05ddfae19a089e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 27 16:37:50 2010 +0000
-
-    gendesc: fix problem with single word descriptions
-
-commit 33f60f48747b5ba12a6fdfb505bb662c922496bd
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 27 12:10:04 2010 +0000
-
-    lcov: remove temporary files when creating a package
-
-commit 6775457cbd3fa86acba4655d77b4ba2054b13253
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 27 12:00:05 2010 +0000
-
-    lcov: correctly retain information about converted test data
-
-commit f4d13eccc54f31a53ad109c3c4b86e4b52d6dfcb
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 27 10:17:43 2010 +0000
-
-    lcov. fixed overview output for function data
-
-commit aa00c65b7514c93320c1c787b848c8277593dcb0
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Jan 26 09:36:19 2010 +0000
-
-    genhtml: don't use too much gcc-specific terms (basic block -> block)
-
-commit 3562f60b9500d8ad167c4629e9d95485308aa665
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 22 16:17:37 2010 +0000
-
-    lcov: consolidate coverage rate classification limits
-    
-    Classifying coverage rates per coverage type (line, function or branch
-    coverage) is not useful in most cases. Also the respective
-    color legend takes up too much space in the HTML output. Remove
-    function and branch coverage rates from the documentation and from
-    the color legend. Instead the original limits will be applied to those
-    coverage types as well. The per type rates can still be used if required
-    but it is recommended to only use one rate set.
-
-commit d77dc6a0adf259e322ac9f35c93241d446269a5b
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 22 16:16:47 2010 +0000
-
-    lcov: minor code cleanup
-    
-    - remove unused function definitions and declarations
-    - remove unused CSS declarations
-    - add missing function declarations
-    - fix function prototypes
-
-commit b3243d1fdc17571ca9b1ed6a1ea975a9b3f1b86b
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 22 16:16:15 2010 +0000
-
-    geninfo: consolidate similar functions
-
-commit 739e2bca054c69975594c2570049e8aa9ae1b5ce
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 22 16:15:35 2010 +0000
-
-    lcov: add coverage result output to more operations
-
-commit 0a31d3c0696015c5e4878e821529eba45451c3dd
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 22 16:14:57 2010 +0000
-
-    lcov: minor cosmetic HTML changes
-    
-    - top level view is now named "top-level"
-    - use sans-serif font for coverage values in file list
-    - use smaller font for show/hide details link
-    - use smaller font for function/source view link
-    - use smaller font for show descriptions link
-
-commit b631fa0cb9aabdf18f9365423f0b0bf85d6b8e16
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 22 16:14:27 2010 +0000
-
-    lcov: improve color legend
-    
-    Move color legend closer to the table containing coverage rates.
-
-commit 2aeeeafb31c36ccd1a51051f040e29a9fcf59df2
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 22 16:13:58 2010 +0000
-
-    lcov: implement branch coverage
-
-commit 49dfe22f41b6c3edcb774dfb89b1a807ce7aee6c
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 22 16:13:34 2010 +0000
-
-    genhtml: implement branch coverage
-
-commit 6aa2422401bb854c9710f5ed2936f06e487848c5
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 22 16:13:07 2010 +0000
-
-    geninfo: implement branch coverage
-
-commit ca2c9781b0a512bd6789eac2b6840405e2d87330
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 22 16:12:27 2010 +0000
-
-    geninfo: consolidate handling of extra gcov parameters
-
-commit 9d9c964eb6ece00b15ef068f176c68cb0eedfda0
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Jan 21 11:26:34 2010 +0000
-
-    lcov: minor fix for lcov --diff
-
-commit 4306f81d1e8446a89fe83d20cd71abe075a3cd61
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Jan 21 10:23:35 2010 +0000
-
-    lcov: improve lcov --list output
-
-commit 3242ce1bae94cfd859c3bc964fab11f85bd7d1ed
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 20 17:13:28 2010 +0000
-
-    lcov: unify data order in tracefiles
-
-commit 8f53b2e8dbbe5580050fbe0c604bd9a9322735a7
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 20 16:05:56 2010 +0000
-
-    lcov: fix bug when applying baseline files without function coverage data
-    
-    Fix the following error that occurs when genthml's --baseline-file option
-    is used on files which do not contain any function data:
-    
-    genhtml: Can't use an undefined value as a HASH reference at ./lcov/bin/genhtml line 4441.
-
-commit 96fcd676d5ac9c1eb9f83f3dc4c3089ba478baad
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 20 15:28:21 2010 +0000
-
-    lcov: resolve short-name option ambiguities
-
-commit f1d34d49b394a13c33c7a5b51f04e5dfbded5d26
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 20 14:47:50 2010 +0000
-
-    lcov: fix error messages
-
-commit 89ff61aa7cd2ca23b8cacd649288ecf7f67746de
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 20 08:35:20 2010 +0000
-
-    lcov: fix bug when using genhtml's --baseline-file option
-    
-    Fix the following error message when trying to use genhtml's
-    --baseline-file option:
-    
-    genhtml: Undefined subroutine &main::add_fnccounts called at
-    /home/oberpar/bin/genhtml line 4560.
-    
-    Reported by Brian DeGeeter <sixarm@gmail.com>
-
-commit c3df3a8504b06ca32b9863fdb2abb8cf0ce62251
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jan 18 09:17:17 2010 +0000
-
-    lcov: ensure LANG=C before calling gcov
-    
-    Fix problem calling lcov when LANG is not set to an english locale.
-    Reported by benoit_belbezet@yahoo.fr.
-
-commit d945f23345e02ca535d740782e7ae10cb3396b8c
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Nov 18 09:39:21 2009 +0000
-
-    lcov: more version fixup
-
-commit 413249e6336cff432083954e6ed47236dd35f647
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Nov 18 09:38:03 2009 +0000
-
-    lcov: fix version fixup
-
-commit d0b7148e2d76164e5ea091fe56035c24f7dce22a
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Nov 18 09:34:45 2009 +0000
-
-    lcov: add more CVS versioning
-
-commit 4e0219f918a15cbc9ff40d0e0e4dab91ac073f72
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Nov 18 09:14:56 2009 +0000
-
-    lcov: add CVS revision number to version output
-
-commit 34154c2d48497d9aad41ec1452ba94dd4cbce881
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Oct 30 14:18:45 2009 +0000
-
-    lcov: further clarification in the README
-
-commit 7a4ab1340dd7f88ba0fb56a7b0eb368bf2d0112e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Oct 30 13:58:56 2009 +0000
-
-    lcov: update README to mention required -lgcov switch during linking
-
-commit 3fa5b311b123af84debbd774baa4a1cd30e7085b
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Oct 27 16:54:41 2009 +0000
-
-    lcov: remove further unneeded warning
-    
-    ... + use correct source for list of filenames
-
-commit cd4051719e72129f4abf1ad177269bf14031f83a
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Oct 27 16:19:05 2009 +0000
-
-    lcov: fix problem with matching filename
-    
-    - used correct source for filenames
-    - converted match_filenames to portable version
-
-commit 0d0ff8a9945260eebed6d316aa08c0021faf3549
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Oct 27 15:29:41 2009 +0000
-
-    lcov: remove unnecessary warning
-
-commit 6c711d664c38d18f788ee8a5239586cd4a5b77d9
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Oct 26 14:21:40 2009 +0000
-
-    lcov: improve derive-func-data option
-    
-    - rewrite graph file handling
-    - make derive data look at all lines belonging to a function to find
-      out whether it has been hit or not
-    - introduce --debug option to better debug problems with graph files
-
-commit 214cda20c4b591a823045f35b73f2a16221c9aa1
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Oct 1 15:26:58 2009 +0000
-
-    lcov: introduce new options --derive-func-data
-    
-    When using a gcov version that does not provide function data,
-    this option will attempt to guess the function coverage data
-    for a function by looking at the number of times that the first
-    line of that function was called.
-
-commit 9a75125895fd07a775a2a25f2cbe66b9fbf332d6
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Oct 1 11:49:53 2009 +0000
-
-    lcov: ignore incomplete function names in .bb files
-    
-    - don't abort processing when an incomplete function name is
-      encountered in a .bb file (gcc 2.95.3 adds those)
-    - fix filename prefix detection
-
-commit d5ab6076a0bfc5ad80652ba592583f7fc7946dc6
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Sep 28 12:27:09 2009 +0000
-
-    lcov: improve detection of gcov-kernel support
-
-commit 3cca782fcac9c4ea54adcebe75e1f047a8dca636
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Sep 22 13:44:04 2009 +0000
-
-    lcov: fix problem with CONFIG_MODVERSIONS
-    
-    Make geninfo work with Linux 2.6.31 and CONFIG_MODVERSIONS.
-
-commit 8af873f44c104cd214b796e13b916718fc8f6f99
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Sep 16 15:24:51 2009 +0000
-
-    lcov: remove default for gcov_dir so that auto-sensing works
-    
-    Fix problem with lcov not finding kernel coverage data at
-    /sys/kernel/debug/gcov because the default system-wide
-    lcovrc file contained a specification for the gcov directory
-    which prevented auto-detection from working.
-
-commit 50f90681af4d105a52b5b0dbf4f0bfd04369ffd2
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Aug 27 10:14:23 2009 +0000
-
-    lcov: apply excluded lines also to function coverage data
-
-commit 4aeb840d25c85a419171970e1a445aeb81079e53
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Aug 27 09:23:13 2009 +0000
-
-    lcov: fix help text typo
-
-commit c17a783f87aa8e42949131d2fbc1c540bb3751a3
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Aug 27 09:22:43 2009 +0000
-
-    lcov: add exclusion markers
-    
-    Users can exclude lines of code from coverage reports by adding keywords
-    to the source code.
-
-commit 445715c88337c13ce496bd05423ee5e58d84705c
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 14 08:19:26 2009 +0000
-
-    lcov: ignore gcov errors for unnamed source files
-    
-    When specifying "--ignore-errors gcov", lcov/geninfo should not abort when
-    they cannot read a .gcov file. Fix this by introducing warnings in the
-    respective places.
-
-commit 0e23f03a9ce130e8ebec679fb5a9a6f854efbee5
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Aug 6 12:34:04 2009 +0000
-
-    lcov: improvements
-    
-    - added --from-package and --to-package options
-    - improved gcov-kernel handling
-
-commit 17a05bdf646870cd61794274c7165211c93c82f9
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Jul 23 12:45:15 2009 +0000
-
-    lcov: fix kernel capture for new gcov-kernel version
-    
-    - fix problems when compiling without O=
-
-commit 64e302b9134b6098852cad2e6180e0722f2dea41
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Jul 21 15:42:44 2009 +0000
-
-    lcov: improve lcov -l output
-
-commit cea6941ef36d0860330b6e94f8c6096dca78ca58
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Jul 21 09:10:49 2009 +0000
-
-    lcov: add support for the linux-2.6.31 upstream gcov kernel support
-
-commit 04470d2b25808f195d338112155b9f7db405d902
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Apr 22 09:13:12 2009 +0000
-
-    genhtml: fix warning about undefined value used
-    
-    nikita@zhuk.fi:
-    genhtml.patch checks that $funcdata->{$func} is defined before using
-    it - I got few "undefined value used" warnings without this check.
-
-commit a12d4f9a5d36232b928be12b7cbfaa9a00b3a923
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Apr 22 09:08:19 2009 +0000
-
-    genpng: fix runtime-warning
-    
-    - when called from within genhtml, genpng would warn about warn_handler
-      being redefined
-
-commit d0b5641c62bbdac89757b9ff185a7aa3f38fc0bb
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Mar 13 09:58:00 2009 +0000
-
-    lcov: improve function name filtering
-    
-    Only remove those characters from function names which would conflict
-    with internal delimiters.
-
-commit fbafa4a5628a639544e83f88083082c685677c36
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Feb 13 15:04:40 2009 +0000
-
-    genhtml: minor man page update
-
-commit 085a2150e38a3c1bdadb5af23c0a8a8a79dc4b0d
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Feb 13 14:56:45 2009 +0000
-
-    genhtml: added --demangle-cpp option
-    
-    - used to convert C++ internal function names to human readable format
-    - based on a patch by slava.semushin@gmail.com
-
-commit 53f3ed4afb45a2a4248314b677d36377598cc73c
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Feb 13 14:07:46 2009 +0000
-
-    genhtml: update comment
-
-commit 3c2b2e8541387506fd514d183f9a4a63c07c0aa4
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Feb 12 17:01:19 2009 +0000
-
-    genhtml: fix error when combining tracefiles without function data
-    
-    - genhtml: Can't use an undefined value as a HASH reference at genhtml
-      line 1506.
-    - bug reported by richard.corden@gmail.com
-
-commit 22397370ada6893b6e9a1c3f6ad0aba7f4864f81
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Feb 11 09:31:24 2009 +0000
-
-    lcov: fix error when combining tracefiles without function data
-    
-    - lcov: Can't use an undefined value as a HASH reference at lcov line
-      1341.
-    - bug reported by richard.corden@gmail.com
-
-commit 24ec53ae83acdd35682ba757adae23750bd4c623
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Feb 9 16:15:49 2009 +0000
-
-    lcov: fix warning when $HOME is not set
-    
-    - based on patch by acalando@free.fr
-
-commit 5da3521d5a438db0a21e93b0d14ea5a3cdab14d9
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Feb 9 12:41:44 2009 +0000
-
-    lcov: use install -pD -m <mode> for file installation
-
-commit bdce1bda2ac1a86aa6dfefae8e18353ba57afe4b
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Feb 9 09:46:00 2009 +0000
-
-    lcov: fix double-counting of function data
-
-commit ea62c4e701abb05dd560ef22b52a4a72c17660e8
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 21 16:33:29 2009 +0000
-
-    geninfo: need to add CR removal to geninfo as well
-    
-    ... or checksumming will fail
-
-commit 70be5df7d58a393e27cee178df669c12ec670c5a
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 21 16:24:01 2009 +0000
-
-    lcov: modify end-of-line CR removal
-    
-    - s///g is 10% slower than s/// - \r may be 0x10 or 0x13 (see man
-      perlport)
-
-commit d8df4b0f83ff175f1a06afb693903ee1a93ec377
-Author: Michael Knigge <michael.knigge@set-software.de>
-Date:   Tue Jan 20 11:41:39 2009 +0000
-
-    lcov: remove CRLF line breaks in source code when generating html output
-    
-    - added patch by michael.knigge@set-software.de
-
-commit 442cca7e69356e7f8ba03bd95f7813576bd197cc
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Nov 17 14:11:20 2008 +0000
-
-    lcov: updated CVS version to 1.8
-
-commit 5c5c85a1c090360facd50cb089b8af98f0b37c47
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Nov 17 13:55:52 2008 +0000
-
-    lcov: version + date updates
-
-commit 9f6a735809c23559b861e97a20af55a66b6b96bb
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Nov 17 13:49:43 2008 +0000
-
-    lcov: fix spec file bug
-
-commit 11483dc0b56d326718edcd31d06458143add858f
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Nov 17 13:44:38 2008 +0000
-
-    lcov: update error and warning messages
-
-commit 4dd11b80d14e34fee2e75b3fe8c7aa163f61ad1d
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Nov 17 12:48:03 2008 +0000
-
-    lcov: preparations for release 1.7
-
-commit b847ed6f3103a4c9f0a48417b9c3f160b9e00557
-Author: Jeff Connelly <jeffconnelly@users.sourceforge.net>
-Date:   Fri Oct 10 07:54:47 2008 +0000
-
-    lcov: geninfo chokes on spaces in the directory name
-    
-    In lcov 1.6, geninfo fails to find gcno/gcda files if the source directory
-    has spaces in the name, because it uses backticks to shell out to "find",
-    passing $directory on the command-line.
-    
-    Attached is a patch that double-quotes the variable, allowing geninfo to
-    operate on directories with spaces in their name. The fix isn't perfect; it
-    won't work on directories with a " character, but it works fine for my
-    purposes (I don't have any directories with quotes). A better fix would be
-    to use IPC::System::Simple's capturex from
-    http://search.cpan.org/~pjf/IPC-System-Simple-0.15/lib/IPC/System/Simple.pm
-    #runx(),_systemx()_and_capturex(). capturex() is a multiple-argument form
-    of the backticks, so it avoids any interpolation errors.
-
-commit ee3cdd554ee4e6d3ef5bdc9c5dcfee50de6375a7
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Aug 18 07:12:33 2008 +0000
-
-    lcov: change sorting order to low-to-high coverage
-
-commit fe665ca5ccf9d73d9ebdae17de88e181c1b9b0eb
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 15 08:38:21 2008 +0000
-
-    lcov: several changes
-    
-    - update download link
-    - unify webpage links
-    - provide --sort and --function-coverage switch + documentation
-
-commit 14137c5456f307982fed418e1e8fac65d7f086c3
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Aug 13 15:57:23 2008 +0000
-
-    lcov: fix function view page creation when --no-func is specified
-
-commit e59f7d15ffc7f1b3794a4212c53d0fb97ac7fb2a
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Aug 13 15:35:48 2008 +0000
-
-    lcov: updated versioning mechanism
-    
-    ... + fixed some man page bugs
-
-commit e933698b31bc2fb4a750d89a5755bb8155313da2
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Aug 13 14:08:23 2008 +0000
-
-    lcov: updated rpm description
-    
-    ... + summary and version strings
-
-commit 5a9660585ce39a77fa38607d0c2d2440955e7242
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Aug 13 13:53:50 2008 +0000
-
-    lcov: integrated function coverage patch
-    
-    ... by Tom Zoernen + sorting function
-
-commit d10ede8179747cfd675a3989578350c710e9bdd5
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed May 7 15:08:12 2008 +0000
-
-    lcov: --norecursion becomes --no-recursion
-    
-    + added docs
-
-commit 4096130608b9faf74c5b5feac554a10b5d9f83ce
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Feb 21 10:20:33 2008 +0000
-
-    lcov: fix error when trying to use genhtml -b
-    
-    genhtml fails when the data file contains an entry which is not
-    found in the base file.
-
-commit 9578099e13388344a6179c7cce54bfa094fd9b08
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Feb 20 17:21:51 2008 +0000
-
-    lcov: fixed problem with pre gcc-3.3 versions
-    
-    read_gcov_headers does not return valid results for pre gcc-3.3 versions.
-    Due to an unnecessary check, parsing of gcov files was aborted. Fix
-    by removing check.
-
-commit 16ec76b48fbc50c32890919e5bd0c30653719af9
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Feb 5 09:18:50 2008 +0000
-
-    lcov: adding support for gzipped html
-    
-    ... based on patch by dnozay@vmware.com
-    
-    dnozay@vmware.com: genhtml is a great tool to generate html, but the more
-    files, the more space it takes (here I have over 113MB of html generated),
-    add to that I need to have different sets, and space usage increases
-    dramatically (2.7GB). we are using browsers with htmlz support, so it would
-    be nice to have support for that in genhtml, relying on 'gzip -S z' to do
-    the job.
-
-commit f2c98a8c8581180533508eb4af41720d8566049e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jan 7 16:33:57 2008 +0000
-
-    Filter non-word characters in function name
-    
-    ... as they would break our file format which uses comma and '=' as
-    field separator.
-
-commit 37725fc78fcacaf06e6240971edc3bdd7fe3d142
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Nov 1 16:29:39 2007 +0000
-
-    lcov: fix for problem resulting in lcov aborting with "ERROR: reading string"
-
-commit 48f13fcec1b521d2daba6202ccd7ec0ec8c5ece9
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Oct 4 08:18:07 2007 +0000
-
-    lcov: workaround for gcc 4.1.0 .gcno file oddness
-    
-    scott.heavner@philips.com:
-    I'm trying to use lcov 1.6 with gcov/gcc 4.1.0. The geninfo parser was
-    aborting on a small number of .gcno files. I've patched my local copy so
-    that geninfo prints out the offset of the error and skips the remainder of
-    the problem file
-
-commit 1a805ea068db29b63a83c801f3bb1840fda8dd35
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 24 08:50:26 2007 +0000
-
-    lcov: add experimental option "--norecursion"
-
-commit 194de5071db1d9903d22164432448b73c1ec6cd0
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Aug 23 11:08:39 2007 +0000
-
-    lcov: Makefile for post-release
-
-commit 0750f8a3e5235833711d616a3763c04103cf55a5
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Aug 23 11:04:30 2007 +0000
-
-    lcov: Makefile for release 1.6
-
-commit cb911f7a79593c89a730dc93fa54179fbf1df363
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Aug 20 10:29:35 2007 +0000
-
-    lcov: fixed spec file
-
-commit 62cefebdda87784140eb5f997ae4e575d2338298
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jul 6 07:38:47 2007 +0000
-
-    lcov: add new option --initial to get zero coverage data from graph files
-
-commit f0b6927f1ab1052b00081c662ced614a6e5f9ed7
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 4 14:38:59 2007 +0000
-
-    lcov: fixed bug that would not delete .gcda files when using -z
-
-commit 13941c3a159caf7dc6ba18a5b13e43c20fc18f2b
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 4 14:18:26 2007 +0000
-
-    lcov: another update in preparation for a new release
-
-commit d25e630a77ef2d0f69139058322269387866e414
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jul 4 13:13:22 2007 +0000
-
-    lcov: man page update
-
-commit 7844b915af5402441df9ab0423e4c20ef9a2632f
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Jul 3 16:43:05 2007 +0000
-
-    lcov: update manpage
-
-commit 5adaa72bfb32737d18c328492777c1c6116d4a9e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jul 2 15:29:02 2007 +0000
-
-    lcov: preparations for new release
-    
-    - updated CHANGES file
-    - added compat-libtool + no-compat-libtool option
-    - changed libtool default to on (due to popular request)
-    - added checksum option
-    - changed checksum default to off (to reduce cpu time + file size)
-    - added geninfo_checksum option to lcovrc, deprecated
-      geninfo_no_checksum
-    - added geninfo_compat_libtool option to lcovrc
-    - minor update of README file
-
-commit 6cbfd5022703a6198e1a1e2a2ddddcc0b90f5334
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue May 22 08:11:44 2007 +0000
-
-    lcov: minor help text update
-
-commit 2416ed02ba299c4d0bceb1e47c214b7dec066d7a
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Mar 7 14:59:25 2007 +0000
-
-    lcov
-    
-    - add --ignore-errors option to lcov/geninfo
-    - add --gcov-tool option to lcov/geninfo
-    - remove s390 test case modification in geninfo
-    - restructured help text for lcov/geninfo
-
-commit a13375811717d3ada718e6f52364e4344a7e3187
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jan 8 17:07:21 2007 +0000
-
-    lcov
-    
-    - re-added libtool compatibility workaround patch by
-      thomas@apestaart.org
-    - added new lcov/geninfo-option --compat_libtool to activate libtool
-      compatibility patch
-
-commit 14871d7b097282819db60266d8b8a38506d7b14a
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Nov 14 11:45:17 2006 +0000
-
-    lcov
-    
-    Fix for problem found by Joerg Hohwieler: lcov -k doesn't work if -k is
-    specified more than once.
-
-commit 43b52b37006822c0fca12548bc72fecc957342ca
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Jun 26 15:48:52 2006 +0000
-
-    lcov: new version for prerelease rpms
-
-commit 89e9d59709c9d9d8722170c86251090adc3b96c9
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jun 7 09:31:57 2006 +0000
-
-    lcov: removed autoupdate of copyright date (second thoughts)
-
-commit bb0cf1c9d0ed58b37c1551fea765fb1622bcacde
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jun 7 09:20:37 2006 +0000
-
-    lcov: minor cleanup (release preparations)
-
-commit 527693d753d11ac2b59fe26b923662c99e6e3715
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Apr 5 10:10:05 2006 +0000
-
-    lcov
-    
-    - added base-directory documentation
-    - updated CHANGES file
-
-commit 11ef9338cc4124801c8b61e3edd51a02e50b4c68
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Mar 20 17:09:50 2006 +0000
-
-    genhtml: added html-extension option
-
-commit 93d22308ffb410327248059b7dcdb592f85e249e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Mar 20 16:39:25 2006 +0000
-
-    genhtml
-    
-    - adding html-prolog and html-epilog options (based on patch by Marcus
-      Boerger)
-    - specified behavior when both --no-prefix and --prefix options where
-      provided
-    - small whitespace diff
-
-commit dcac095cdc00cc65930285bb6fc01d0f257ee4ed
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Feb 15 16:02:07 2006 +0000
-
-    lcov: added check for invalid characters in test names
-
-commit d89e561dfd9c5fde43350af1b145b1892d0710d0
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Dec 2 06:38:16 2005 +0000
-
-    lcov
-    
-    - updated Makefile so that people building RPMs from the CVS version get
-      a correct build version. Note: this needs to be adjusted after each
-      release!
-
-commit 1960123050f9098690768d10cd2490dd49b995f7
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Thu Nov 10 13:10:09 2005 +0000
-
-    lcov
-    
-    - fixed bug: .info file generation with new gcc 4.x compilers may fail
-      for programming languages that allow ':' in function names (c++,
-      objective c)
-    - removed special handling for libtool .libs files
-    - libtool should work with currently undocumented option --base-directory
-
-commit 479d446d3bf20a84c2933100ead279c79eeaf5c4
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Sep 7 16:24:39 2005 +0000
-
-    lcov
-    
-    - implementation of new option --base-directory (untested, undocumented)
-    - minor fix for link-traversal when looking for object directory
-    
-    TODO: document option (man page, online help), add to config file, check
-    whether libtool fix still works
-
-commit 770b94a3172f206de7f194c7497ebae14348b521
-Author: Robert Williamson <robbiew@users.sourceforge.net>
-Date:   Mon Jul 11 17:54:25 2005 +0000
-
-    Applied patch from Stefan Kost
-    
-    when running lcov over an uninstalled user-space apps tests, it finds
-    the .da file in the .libs directories, but does not look for the sources
-    one hierarchy up. Libtool places the object in the .libs dirs. when
-    running gcov manually one can specify -o.libs/ to produce a source.c.gov
-    file. I now have attached a patch that fixes the problem for me. please
-    do not just ignore this report. the lcov tool is so nice and it would be
-    a shame if it can not be used for normal apps.
-
-commit 79f2ff2c168150e7532046c2cdbc1e42c8b4708f
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Jun 14 11:34:59 2005 +0000
-
-    lcov
-    
-    - renamed support for modified compilers (gcc 3.3 hammer patch)
-    - fixed bugs in the support for modified compilers
-
-commit fb7dab3494fdd8b093e6a84f088f6ea07fcefe6e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Mar 15 18:02:54 2005 +0000
-
-    lcov
-    
-    Emil.Jansson@oss.teleca.se:
-    lcov 1.4 does not work with the gcc version in Mandrake Linux 10.0
-    
-    >> gcc --version
-    
-    gcc (GCC) 3.3.2 (Mandrake Linux 10.0 3.3.2-6mdk)
-    
-    This patch for geninfo fixes the problem:
-
-commit ae3fe899d824e8af8a16736a0c8104c903565a56
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Mar 8 14:23:06 2005 +0000
-
-    lcov
-    
-    - added optional legend to HTML output
-    - changed background color for "good coverage" entries to green for
-      consistency reasons
-
-commit 18b73d39fd9d6bc8829395baa612a6ed98b89efe
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Mar 2 14:49:47 2005 +0000
-
-    lcov
-    
-    - fixed rpm build process to exclude unnecessary directories in RPM
-
-commit ef6ee74df5bf1d1d104322f8fff36b5c6fda34b4
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Mar 2 12:48:29 2005 +0000
-
-    lcov
-    
-    - added man page for configuration file lcovrc
-
-commit be3afe2626d6bc72256e1873d409c737ac4391c9
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Feb 28 16:31:51 2005 +0000
-
-    lcov
-    
-    - Updated CHANGES file in preparation for a new release
-
-commit dc68ce9c804ef21bc8e149d9b468e18c1619bb54
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Nov 2 15:48:45 2004 +0000
-
-    lcov
-    
-    - temporary fix for a problem which occurs when trying to parse C++
-      coverage data generated with vanilla gcc 3.3.3
-
-commit efedc5b930ab6743ea9f47ce4ea4a1a75bd739ff
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Sep 27 13:13:51 2004 +0000
-
-    lcov
-    
-    - fix for minor bug in geninfo (access to uninitialized variable)
-      related to SLES9 compatibility test and test for existing source code
-      files
-
-commit 47943eedfbec7a12c52e7a8ccbcfaf8d0706f142
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Sep 20 14:11:16 2004 +0000
-
-    lcov
-    
-    - minor fix for regular expression used to parse .gcov files - caused
-      problems when parsing branch coverage data and when using custom
-      gcov versions
-
-commit ce6335ebd92ce017b75ee3e194e9e3ca7bc7e1f3
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Sep 14 15:52:38 2004 +0000
-
-    lcov
-    
-    - fixed bug in geninfo which would not report any FN: data for data
-      generated with gcc versions 3.4.0 and above
-
-commit 58df8af3a62fa4e60569ef300e0ddd0073bf109e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Aug 31 15:57:41 2004 +0000
-
-    lcov
-    
-    - added support for modified GCC version provided by SUSE SLES9
-
-commit 69f3bc3a0c59b35eb6882205286a68b04a8a8d22
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Aug 31 15:48:32 2004 +0000
-
-    lcov
-    
-    - fixed bug in lcov RPM spec file which would not include the global
-      config file in the package list
-
-commit 5d10ca22144ad2be885405c3683b20c0976f7562
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Aug 9 14:32:23 2004 +0000
-
-    lcov
-    
-    - fixed a bug which would cause generation of incorrect line checksums
-      when source code is not available while capturing coverage data
-    - changed default directory for temporary files from . to /tmp
-
-commit 8ee3061f23f17a5074deda0777c66c3e82b5d852
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Aug 9 11:15:02 2004 +0000
-
-    lcov
-    
-    - added configuration file support
-    - fixed Makefile error for target "uninstall"
-
-commit 58af07f0b0ca1af8c9f2b90ad1683447bb560165
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Aug 6 11:36:33 2004 +0000
-
-    lcov
-    
-    - fixed bug which would cause an error when lcov was used on a source
-      directory which contained perl regular expression special characters
-    - simplified regular expression character escaping
-    - removed unnecessary function escape_shell from lcov
-
-commit 69a6918d4cd386aff2fbff093a6e0b5ddcc46602
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Mar 30 13:27:55 2004 +0000
-
-    lcov: - added --path option to fix --diff functionality
-
-commit cbc6cb11b532e525ae8b0c0742a4fd41189ca7c2
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Mar 29 12:56:08 2004 +0000
-
-    lcov
-    
-    - Added compatibility for gcc-3.4
-    - Modified --diff function to better cope with ambiguous entries in
-      patch files
-    - Modified --capture option to use modprobe before insmod (needed for
-      2.6)
-
-commit 1cf9a02c3ea0e98cc1d8b626eaa0a2a1cbd96cf1
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Jan 30 09:42:13 2004 +0000
-
-    lcov
-    
-    - updated CHANGES file
-    - changed Makefile install path (/usr/local/bin -> /usr/bin)
-
-commit c60f0668059032cf4dc5f6c556fd6117925f535f
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Jan 14 10:14:10 2004 +0000
-
-    lcov-patch by Laurent Deniel
-    
-    avoids aborting the geninfo processing when an empty .bb file is
-    encountered (e.g. source code with no profiled statement)
-
-commit 7f2966f8f874a6c905b4d31e5aaf0f4654929044
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Dec 19 16:22:52 2003 +0000
-
-    lcov: updated references to lcov webpage to reflect recent site changes
-
-commit a3893f4eb2b4fadc4d7350324d74fa453a5ba0f3
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Dec 19 12:50:28 2003 +0000
-
-    Added changes by Laurent Deniel
-    
-    - a small patch to lcov 1.1 that introduces the --follow option (in
-      lcov & geninfo) to control whether or not links should be followed
-      while searching for .da files.
-    - a workaround for a gcov (3.2) bug which aborts with empty .da files
-      (gcov 3.3 is fixed but many distributions include gcc 3.2)
-
-commit d44f2f8e8672e31cc104c0598b0556a5949dc067
-Author: Paul Larson <plars@users.sourceforge.net>
-Date:   Fri Nov 21 19:34:59 2003 +0000
-
-    Fixed two buglets that caused geninfo to break with some versions of gcov.
-    
-    1. Return value for gcov --help might not be 0, expect -1 when it
-       doesn't exist
-    2. use -b instead of expanded (--branch-coverage or whatever it was)
-
-commit 5a1a33a840a665c77409f799be91cc2dce5cd3b2
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Tue Nov 18 14:06:47 2003 +0000
-
-    lcov
-    
-    - fixed function which interprets branch possibility data in geninfo
-      (branch x taken = y% would not be interpreted correctly)
-    - deactivated function which would add 'uname -a' output to testname
-      in geninfo (output in genhtml/showdetails looked unreadable, there
-      needs to be some better solution)
-
-commit e0ea03fedf43a3232c35708f882d7058998b2b3d
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Oct 10 14:18:32 2003 +0000
-
-    New function and bug fix update.
-    
-    Makefile:
-    - Added rule to build source rpm
-    
-    lcov.spec:
-    - Modified to support building source rpms
-    
-    genhtml:
-    - Fixed bug which would not correctly associate data sets with an empty
-      test name (only necessary when using --show-details in genhtml)
-    - Added checksumming mechanism: each tracefile now contains a checksum for
-      each instrumented line to detect incompatible data
-    - Implemented new command line option '--nochecksum' to suppress generation
-      of checksums
-    - Implemented new command line option '--highlight' which highlights lines of
-      code which were only covered in converted tracefiles (see '--diff' option of
-      lcov)
-    
-    geninfo:
-    - Added checksumming mechanism: each tracefile now contains a checksum for
-      each instrumented line to detect incompatible data
-    - Implemented new command line option '--nochecksum' to suppress generation
-      of checksums
-    - Added function to collect branch coverage data
-    
-    lcov:
-    - Fixed bug which would not correctly associate data sets with an empty
-      test name (only necessary when using --show-details in genhtml)
-    - Cleaned up internal command line option check
-    - Added info() output when reading tracefiles
-    - Added checksumming mechanism: each tracefile now contains a checksum for
-      each instrumented line to detect incompatible data
-    - Implemented new command line option '--nochecksum' to suppress generation
-      of checksums
-    - Implemented new command line option '--diff' which allows converting
-      coverage data from an older source code version by using a diff file
-      to map line numbers
-    
-    genpng:
-    - Added support for the highlighting option of genhtml
-    - Corrected tab to spaces conversion
-
-commit c17af02b4a856d8733a763e6c0685c31f3c7fb74
-Author: Nigel Hinds <nhinds@users.sourceforge.net>
-Date:   Fri Sep 19 21:51:06 2003 +0000
-
-    capture branch coverage data from GCOV.
-
-commit e2fc88f85254017bcf1fb04a3c935395a9b7a4a1
-Author: James M Kenefick Jr <parseexception@users.sourceforge.net>
-Date:   Thu Sep 4 16:56:10 2003 +0000
-
-    Initial checking of the galaxy map
-
-commit dfec606f3b30e1ac0f4114cfb98b29f91e9edb21
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Sat Jul 5 13:48:45 2003 +0000
-
-    LCOV: Fixed negative count handling
-    
-    - Negative counts are treated as zero
-    - Warning is issued when encountering negative counts
-
-commit a2ee105a07b19c52efe7a3e6e5b11a27b4b60ef8
-Author: Paul Larson <plars@users.sourceforge.net>
-Date:   Wed Jul 2 19:37:50 2003 +0000
-
-    Small fixes before the release
-
-commit 72860625dd904f84909253b20a7fc024b4e3377e
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon May 5 08:32:04 2003 +0000
-
-    Adjusted example program and README file
-    
-    ... to reflect renaming of lcov option '--reset' to '--zerocounters'.
-
-commit cbd9e315832960604d2949439326b30f4061e512
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Apr 30 15:47:51 2003 +0000
-
-    Renamed lcov option '--reset' to '--zerocounters'
-    
-    - Included '--remove' in help text of lcov
-    - Adjusted man pages to include option changes
-    - Extended info() change to geninfo and genhtml (infos are now printed
-      to STDERR)
-
-commit 8155960cb5db0359470d2a5f652bdc744e9ecfcd
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Wed Apr 16 15:43:31 2003 +0000
-
-    Modified read_gcov so that it can also parse the new gcov format which is to be introduced in gcc 3.3.
-
-commit 382440f781b12ade8f1f7962a0eb1cfc0525f2a5
-Author: Paul Larson <plars@users.sourceforge.net>
-Date:   Tue Apr 15 16:06:59 2003 +0000
-
-    Added --remove option info() now prints to stderr
-
-commit 62760fa1840326e849c7e58892ce671f510bb0af
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Mon Apr 14 09:31:51 2003 +0000
-
-    Check-in of updated LCOV version (to be released as 1.1).
-    
-    Includes fixes and modifications by Mike Kobler, Paul Larson and
-    myself.
-    
-    A quote from the CHANGS file:
-    - Added CHANGES file
-    - Added Makefile implementing the following targets:
-      * install    : install LCOV scripts and man pages
-      * uninstall  : revert previous installation
-      * dist       : create lcov.tar.gz file and lcov.rpm file
-      * clean      : clean up example directory, remove .tar and .rpm files
-    - Added man pages for all scripts
-    - Added example program to demonstrate the use of LCOV with a userspace
-      application
-    - Implemented RPM build process
-    - New directory structure:
-      * bin        : contains all executables
-      * example    : contains a userspace example for LCOV
-      * man        : contains man pages
-      * rpm        : contains files required for the RPM build process
-    - LCOV-scripts are now in bin/
-    - Removed .pl-extension from LCOV-script files
-    - Renamed readme.txt to README
-    
-    README:
-    - Adjusted mailing list address to ltp-coverage@lists.sourceforge.net
-    - Fixed incorrect parameter '--output-filename' in example LCOV call
-    - Removed tool descriptions and turned them into man pages
-    - Installation instructions now refer to RPM and tarball
-    
-    descriptions.tests:
-    - Fixed some spelling errors
-    
-    genhtml:
-    - Fixed bug which resulted in an error when trying to combine .info files
-      containing data without a test name
-    - Fixed bug which would not correctly handle data files in directories
-      with names containing some special characters ('+', etc.)
-    - Added check for empty tracefiles to prevent division-by-zeros
-    - Implemented new command line option --num-spaces / the number of spaces
-      which replace a tab in source code view is now user defined
-    - Fixed tab expansion so that in source code view, a tab doesn't produce a
-      fixed number of spaces, but as many spaces as are needed to advance to the
-      next tab position
-    - Output directory is now created if it doesn't exist
-    - Renamed "overview page" to "directory view page"
-    - HTML output pages are now titled "LCOV" instead of "GCOV"
-    
-    geninfo:
-    - Fixed bug which would not allow .info files to be generated in directories
-      with names containing some special characters
-    
-    lcov:
-    - Fixed bug which would cause lcov to fail when the tool is installed in
-      a path with a name containing some special characters
-    - Implemented new command line option '--add-tracefile' which allows the
-      combination of data from several tracefiles
-    - Implemented new command line option '--list' which lists the contents
-      of a tracefile
-    - Implemented new command line option '--extract' which allows extracting
-      data for a particular set of files from a tracefile
-    - Fixed name of gcov kernel module (new package contains gcov-prof.c)
-    - Changed name of gcov kernel directory from /proc/gcov to a global constant
-      so that it may be changed easily when required in future versions
-
-commit ec94ed71838a9780e82ea8bd67742bde2f4eeb47
-Author: Paul Larson <plars@users.sourceforge.net>
-Date:   Fri Mar 7 20:28:15 2003 +0000
-
-    Fix lcov.pl to work with the new gcov-kernel module
-    
-    ... ,documentation fixes in readme.txt
-
-commit e70d9abdb60b83de7174815371259c63fa75bf76
-Author: Robert Williamson <robbiew@users.sourceforge.net>
-Date:   Tue Feb 18 20:05:09 2003 +0000
-
-    Applied patch from Mike Kobler:
-    
-    One of my source file paths includes a "+" in the directory name.  I found
-    that genhtml.pl died when it encountered it. I was able to fix the problem
-    by modifying the string with the escape character before parsing it.
-
-commit 69ef6f1b607670589aae1ae1e6c78ef1b5d204e3
-Author: Peter Oberparleiter <oberpapr@users.sourceforge.net>
-Date:   Fri Sep 6 09:04:34 2002 +0000
-
-    Replaced reference to "cat" cvs directory
-    
-    ... and to .zip package.
-
-commit c641f6e694e2bebf9ef0a507091460026463d169
-Author: Manoj Iyer <iyermanoj@users.sourceforge.net>
-Date:   Thu Sep 5 19:14:51 2002 +0000
-
-    Coverage analysis files.
-    
-    Peter worked on this version.

externals/lcov/CONTRIBUTING

-Contributing to LCOV
-====================
-
-Please read this document if you would like to help improving the LTP GCOV
-extension (LCOV). In general, all types of contributions are welcome, for
-example:
-
- * Fixes for code or documentation
- * Performance and compatibility improvements
- * Functional enhancements
-
-There are some rules that these contributions must follow to be acceptable for
-inclusion:
-
- 1. The contribution must align with the project goals of LCOV.
- 2. The contribution must follow a particular format.
- 3. The contribution must be signed.
-
-Once you have made sure that your contribution follows these rules, send it via
-e-mail to the LTP coverage mailing list [1].
-
-
-Signing your work
-=================
-
-All contributions to LCOV must be signed by putting the following line at the
-end of the explanation of a patch:
-
-  Signed-off-by: Your Name <your.email@example.org>
-
-By signing a patch, you certify the following:
-
-  By making a contribution to the LTP GCOV extension (LCOV) on
-  http://ltp.sourceforge.net, I certify that:
-
-  a) The contribution was created by me and I have the right to submit it
-     under the terms and conditions of the open source license
-     "GNU General Public License, version 2 or later".
-     (http://www.gnu.org/licenses/old-licenses/gpl-2.0.html).
-
-  b) The contribution is made free of any other party's intellectual property
-     claims or rights.
-
-  c) I understand and agree that this project and the contribution are public
-     and that a record of the contribution (including all personal information
-     I submit with it, including my sign-off) is maintained indefinitely and
-     may be redistributed consistent with this project or the open source
-     license(s) involved.
-
-
-Project goals
-=============
-
-The goal of LCOV is to provide a set of command line tools that can be used to
-collect, process and visualize code coverage data as produced by the gcov tool
-that is part of the GNU Compiler Collection (GCC) [2].
-
-If you have an idea for a contribution but are unsure if it aligns with the
-project goals, feel free to discuss the idea on the LTP coverage mailing
-list [1].
-
-
-Contribution format
-===================
-
-To contribute a change, please create a patch using 'git format-patch'.
-Alternatively you can use the diff utility with the following command line
-options:
-
-  diff -Naurp
-
-Please base your changes on the most current version of LCOV. You can use the
-following command line to obtain this version from the lcov Git repository:
-
- git clone https://github.com/linux-test-project/lcov.git
-
-Add a meaningful description of the contribution to the top of the patch. The
-description should follow this format:
-
-  component: short description
-
-  detailed description
-
-  Signed-off-by: Your Name <your.email@example.org>
-
-With your Signed-off-by, you certify the rules stated in section
-"Signing your work".
-
-
--- 
-
-[1] ltp-coverage@lists.sourceforge.net
-[2] http://gcc.gnu.org

externals/lcov/COPYING

-		    GNU GENERAL PUBLIC LICENSE
-		       Version 2, June 1991
-
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
- 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-			    Preamble
-
-  The licenses for most software are designed to take away your
-freedom to share and change it.  By contrast, the GNU General Public
-License is intended to guarantee your freedom to share and change free
-software--to make sure the software is free for all its users.  This
-General Public License applies to most of the Free Software
-Foundation's software and to any other program whose authors commit to
-using it.  (Some other Free Software Foundation software is covered by
-the GNU Lesser General Public License instead.)  You can apply it to
-your programs, too.
-
-  When we speak of free software, we are referring to freedom, not
-price.  Our General Public Licenses are designed to make sure that you
-have the freedom to distribute copies of free software (and charge for
-this service if you wish), that you receive source code or can get it
-if you want it, that you can change the software or use pieces of it
-in new free programs; and that you know you can do these things.
-
-  To protect your rights, we need to make restrictions that forbid
-anyone to deny you these rights or to ask you to surrender the rights.
-These restrictions translate to certain responsibilities for you if you
-distribute copies of the software, or if you modify it.
-
-  For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must give the recipients all the rights that
-you have.  You must make sure that they, too, receive or can get the
-source code.  And you must show them these terms so they know their
-rights.
-
-  We protect your rights with two steps: (1) copyright the software, and
-(2) offer you this license which gives you legal permission to copy,
-distribute and/or modify the software.
-
-  Also, for each author's protection and ours, we want to make certain
-that everyone understands that there is no warranty for this free
-software.  If the software is modified by someone else and passed on, we
-want its recipients to know that what they have is not the original, so
-that any problems introduced by others will not reflect on the original
-authors' reputations.
-
-  Finally, any free program is threatened constantly by software
-patents.  We wish to avoid the danger that redistributors of a free
-program will individually obtain patent licenses, in effect making the
-program proprietary.  To prevent this, we have made it clear that any
-patent must be licensed for everyone's free use or not licensed at all.
-
-  The precise terms and conditions for copying, distribution and
-modification follow.
-
-		    GNU GENERAL PUBLIC LICENSE
-   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-  0. This License applies to any program or other work which contains
-a notice placed by the copyright holder saying it may be distributed
-under the terms of this General Public License.  The "Program", below,
-refers to any such program or work, and a "work based on the Program"
-means either the Program or any derivative work under copyright law:
-that is to say, a work containing the Program or a portion of it,
-either verbatim or with modifications and/or translated into another
-language.  (Hereinafter, translation is included without limitation in
-the term "modification".)  Each licensee is addressed as "you".
-
-Activities other than copying, distribution and modification are not
-covered by this License; they are outside its scope.  The act of
-running the Program is not restricted, and the output from the Program
-is covered only if its contents constitute a work based on the
-Program (independent of having been made by running the Program).
-Whether that is true depends on what the Program does.
-
-  1. You may copy and distribute verbatim copies of the Program's
-source code as you receive it, in any medium, provided that you
-conspicuously and appropriately publish on each copy an appropriate
-copyright notice and disclaimer of warranty; keep intact all the
-notices that refer to this License and to the absence of any warranty;
-and give any other recipients of the Program a copy of this License
-along with the Program.
-
-You may charge a fee for the physical act of transferring a copy, and
-you may at your option offer warranty protection in exchange for a fee.
-
-  2. You may modify your copy or copies of the Program or any portion
-of it, thus forming a work based on the Program, and copy and
-distribute such modifications or work under the terms of Section 1
-above, provided that you also meet all of these conditions:
-
-    a) You must cause the modified files to carry prominent notices
-    stating that you changed the files and the date of any change.
-
-    b) You must cause any work that you distribute or publish, that in
-    whole or in part contains or is derived from the Program or any
-    part thereof, to be licensed as a whole at no charge to all third
-    parties under the terms of this License.
-
-    c) If the modified program normally reads commands interactively
-    when run, you must cause it, when started running for such
-    interactive use in the most ordinary way, to print or display an
-    announcement including an appropriate copyright notice and a
-    notice that there is no warranty (or else, saying that you provide
-    a warranty) and that users may redistribute the program under
-    these conditions, and telling the user how to view a copy of this
-    License.  (Exception: if the Program itself is interactive but
-    does not normally print such an announcement, your work based on
-    the Program is not required to print an announcement.)
-
-These requirements apply to the modified work as a whole.  If
-identifiable sections of that work are not derived from the Program,
-and can be reasonably considered independent and separate works in
-themselves, then this License, and its terms, do not apply to those
-sections when you distribute them as separate works.  But when you
-distribute the same sections as part of a whole which is a work based
-on the Program, the distribution of the whole must be on the terms of
-this License, whose permissions for other licensees extend to the
-entire whole, and thus to each and every part regardless of who wrote it.
-
-Thus, it is not the intent of this section to claim rights or contest
-your rights to work written entirely by you; rather, the intent is to
-exercise the right to control the distribution of derivative or
-collective works based on the Program.
-
-In addition, mere aggregation of another work not based on the Program
-with the Program (or with a work based on the Program) on a volume of
-a storage or distribution medium does not bring the other work under
-the scope of this License.
-
-  3. You may copy and distribute the Program (or a work based on it,
-under Section 2) in object code or executable form under the terms of
-Sections 1 and 2 above provided that you also do one of the following:
-
-    a) Accompany it with the complete corresponding machine-readable
-    source code, which must be distributed under the terms of Sections
-    1 and 2 above on a medium customarily used for software interchange; or,
-
-    b) Accompany it with a written offer, valid for at least three
-    years, to give any third party, for a charge no more than your
-    cost of physically performing source distribution, a complete
-    machine-readable copy of the corresponding source code, to be
-    distributed under the terms of Sections 1 and 2 above on a medium
-    customarily used for software interchange; or,
-
-    c) Accompany it with the information you received as to the offer
-    to distribute corresponding source code.  (This alternative is
-    allowed only for noncommercial distribution and only if you
-    received the program in object code or executable form with such
-    an offer, in accord with Subsection b above.)
-
-The source code for a work means the preferred form of the work for
-making modifications to it.  For an executable work, complete source
-code means all the source code for all modules it contains, plus any
-associated interface definition files, plus the scripts used to
-control compilation and installation of the executable.  However, as a
-special exception, the source code distributed need not include
-anything that is normally distributed (in either source or binary
-form) with the major components (compiler, kernel, and so on) of the
-operating system on which the executable runs, unless that component
-itself accompanies the executable.
-
-If distribution of executable or object code is made by offering
-access to copy from a designated place, then offering equivalent
-access to copy the source code from the same place counts as
-distribution of the source code, even though third parties are not
-compelled to copy the source along with the object code.
-
-  4. You may not copy, modify, sublicense, or distribute the Program
-except as expressly provided under this License.  Any attempt
-otherwise to copy, modify, sublicense or distribute the Program is
-void, and will automatically terminate your rights under this License.
-However, parties who have received copies, or rights, from you under
-this License will not have their licenses terminated so long as such
-parties remain in full compliance.
-
-  5. You are not required to accept this License, since you have not
-signed it.  However, nothing else grants you permission to modify or
-distribute the Program or its derivative works.  These actions are
-prohibited by law if you do not accept this License.  Therefore, by
-modifying or distributing the Program (or any work based on the
-Program), you indicate your acceptance of this License to do so, and
-all its terms and conditions for copying, distributing or modifying
-the Program or works based on it.
-
-  6. Each time you redistribute the Program (or any work based on the
-Program), the recipient automatically receives a license from the
-original licensor to copy, distribute or modify the Program subject to
-these terms and conditions.  You may not impose any further
-restrictions on the recipients' exercise of the rights granted herein.
-You are not responsible for enforcing compliance by third parties to
-this License.
-
-  7. If, as a consequence of a court judgment or allegation of patent
-infringement or for any other reason (not limited to patent issues),
-conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License.  If you cannot
-distribute so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you
-may not distribute the Program at all.  For example, if a patent
-license would not permit royalty-free redistribution of the Program by
-all those who receive copies directly or indirectly through you, then
-the only way you could satisfy both it and this License would be to
-refrain entirely from distribution of the Program.
-
-If any portion of this section is held invalid or unenforceable under
-any particular circumstance, the balance of the section is intended to
-apply and the section as a whole is intended to apply in other
-circumstances.
-
-It is not the purpose of this section to induce you to infringe any
-patents or other property right claims or to contest validity of any
-such claims; this section has the sole purpose of protecting the
-integrity of the free software distribution system, which is
-implemented by public license practices.  Many people have made
-generous contributions to the wide range of software distributed
-through that system in reliance on consistent application of that
-system; it is up to the author/donor to decide if he or she is willing
-to distribute software through any other system and a licensee cannot
-impose that choice.
-
-This section is intended to make thoroughly clear what is believed to
-be a consequence of the rest of this License.
-
-  8. If the distribution and/or use of the Program is restricted in
-certain countries either by patents or by copyrighted interfaces, the
-original copyright holder who places the Program under this License
-may add an explicit geographical distribution limitation excluding
-those countries, so that distribution is permitted only in or among
-countries not thus excluded.  In such case, this License incorporates
-the limitation as if written in the body of this License.
-
-  9. The Free Software Foundation may publish revised and/or new versions
-of the General Public License from time to time.  Such new versions will
-be similar in spirit to the present version, but may differ in detail to
-address new problems or concerns.
-
-Each version is given a distinguishing version number.  If the Program
-specifies a version number of this License which applies to it and "any
-later version", you have the option of following the terms and conditions
-either of that version or of any later version published by the Free
-Software Foundation.  If the Program does not specify a version number of
-this License, you may choose any version ever published by the Free Software
-Foundation.
-
-  10. If you wish to incorporate parts of the Program into other free
-programs whose distribution conditions are different, write to the author
-to ask for permission.  For software which is copyrighted by the Free
-Software Foundation, write to the Free Software Foundation; we sometimes
-make exceptions for this.  Our decision will be guided by the two goals
-of preserving the free status of all derivatives of our free software and
-of promoting the sharing and reuse of software generally.
-
-			    NO WARRANTY
-
-  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
-FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
-OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
-PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
-OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
-TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
-PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
-REPAIR OR CORRECTION.
-
-  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
-REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
-INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
-OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
-TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
-YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
-PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGES.
-
-		     END OF TERMS AND CONDITIONS
-
-	    How to Apply These Terms to Your New Programs
-
-  If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these terms.
-
-  To do so, attach the following notices to the program.  It is safest
-to attach them to the start of each source file to most effectively
-convey the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
-    <one line to give the program's name and a brief idea of what it does.>
-    Copyright (C) <year>  <name of author>
-
-    This program is free software; you can redistribute it and/or modify
-    it under the terms of the GNU General Public License as published by
-    the Free Software Foundation; either version 2 of the License, or
-    (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU General Public License for more details.
-
-    You should have received a copy of the GNU General Public License along
-    with this program; if not, write to the Free Software Foundation, Inc.,
-    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-
-Also add information on how to contact you by electronic and paper mail.
-
-If the program is interactive, make it output a short notice like this
-when it starts in an interactive mode:
-
-    Gnomovision version 69, Copyright (C) year name of author
-    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
-    This is free software, and you are welcome to redistribute it
-    under certain conditions; type `show c' for details.
-
-The hypothetical commands `show w' and `show c' should show the appropriate
-parts of the General Public License.  Of course, the commands you use may
-be called something other than `show w' and `show c'; they could even be
-mouse-clicks or menu items--whatever suits your program.
-
-You should also get your employer (if you work as a programmer) or your
-school, if any, to sign a "copyright disclaimer" for the program, if
-necessary.  Here is a sample; alter the names:
-
-  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
-  `Gnomovision' (which makes passes at compilers) written by James Hacker.
-
-  <signature of Ty Coon>, 1 April 1989
-  Ty Coon, President of Vice
-
-This General Public License does not permit incorporating your program into
-proprietary programs.  If your program is a subroutine library, you may
-consider it more useful to permit linking proprietary applications with the
-library.  If this is what you want to do, use the GNU Lesser General
-Public License instead of this License.

externals/lcov/Makefile

-#
-# Makefile for LCOV
-#
-# Make targets:
-#   - install:   install LCOV tools and man pages on the system
-#   - uninstall: remove tools and man pages from the system
-#   - dist:      create files required for distribution, i.e. the lcov.tar.gz
-#                and the lcov.rpm file. Just make sure to adjust the VERSION
-#                and RELEASE variables below - both version and date strings
-#                will be updated in all necessary files.
-#   - clean:     remove all generated files
-#
-
-VERSION := $(shell bin/get_version.sh --version)
-RELEASE := $(shell bin/get_version.sh --release)
-FULL    := $(shell bin/get_version.sh --full)
-
-# Set this variable during 'make install' to specify the Perl interpreter used in
-# installed scripts, or leave empty to keep the current interpreter.
-export LCOV_PERL_PATH := /usr/bin/perl
-
-PREFIX  := /usr/local
-
-CFG_DIR := $(PREFIX)/etc
-BIN_DIR := $(PREFIX)/bin
-MAN_DIR := $(PREFIX)/share/man
-TMP_DIR := $(shell mktemp -d)
-FILES   := $(wildcard bin/*) $(wildcard man/*) README Makefile \
-	   $(wildcard rpm/*) lcovrc
-
-.PHONY: all info clean install uninstall rpms test
-
-all: info
-
-info:
-	@echo "Available make targets:"
-	@echo "  install   : install binaries and man pages in DESTDIR (default /)"
-	@echo "  uninstall : delete binaries and man pages from DESTDIR (default /)"
-	@echo "  dist      : create packages (RPM, tarball) ready for distribution"
-	@echo "  test      : perform self-tests"
-
-clean:
-	rm -f lcov-*.tar.gz
-	rm -f lcov-*.rpm
-	make -C example clean
-	make -C test -s clean
-
-install:
-	bin/install.sh bin/lcov $(DESTDIR)$(BIN_DIR)/lcov -m 755
-	bin/install.sh bin/genhtml $(DESTDIR)$(BIN_DIR)/genhtml -m 755
-	bin/install.sh bin/geninfo $(DESTDIR)$(BIN_DIR)/geninfo -m 755
-	bin/install.sh bin/genpng $(DESTDIR)$(BIN_DIR)/genpng -m 755
-	bin/install.sh bin/gendesc $(DESTDIR)$(BIN_DIR)/gendesc -m 755
-	bin/install.sh man/lcov.1 $(DESTDIR)$(MAN_DIR)/man1/lcov.1 -m 644
-	bin/install.sh man/genhtml.1 $(DESTDIR)$(MAN_DIR)/man1/genhtml.1 -m 644
-	bin/install.sh man/geninfo.1 $(DESTDIR)$(MAN_DIR)/man1/geninfo.1 -m 644
-	bin/install.sh man/genpng.1 $(DESTDIR)$(MAN_DIR)/man1/genpng.1 -m 644
-	bin/install.sh man/gendesc.1 $(DESTDIR)$(MAN_DIR)/man1/gendesc.1 -m 644
-	bin/install.sh man/lcovrc.5 $(DESTDIR)$(MAN_DIR)/man5/lcovrc.5 -m 644
-	bin/install.sh lcovrc $(DESTDIR)$(CFG_DIR)/lcovrc -m 644
-	bin/updateversion.pl $(DESTDIR)$(BIN_DIR)/lcov $(VERSION) $(RELEASE) $(FULL)
-	bin/updateversion.pl $(DESTDIR)$(BIN_DIR)/genhtml $(VERSION) $(RELEASE) $(FULL)
-	bin/updateversion.pl $(DESTDIR)$(BIN_DIR)/geninfo $(VERSION) $(RELEASE) $(FULL)
-	bin/updateversion.pl $(DESTDIR)$(BIN_DIR)/genpng $(VERSION) $(RELEASE) $(FULL)
-	bin/updateversion.pl $(DESTDIR)$(BIN_DIR)/gendesc $(VERSION) $(RELEASE) $(FULL)
-	bin/updateversion.pl $(DESTDIR)$(MAN_DIR)/man1/lcov.1 $(VERSION) $(RELEASE) $(FULL)
-	bin/updateversion.pl $(DESTDIR)$(MAN_DIR)/man1/genhtml.1 $(VERSION) $(RELEASE) $(FULL)
-	bin/updateversion.pl $(DESTDIR)$(MAN_DIR)/man1/geninfo.1 $(VERSION) $(RELEASE) $(FULL)
-	bin/updateversion.pl $(DESTDIR)$(MAN_DIR)/man1/genpng.1 $(VERSION) $(RELEASE) $(FULL)
-	bin/updateversion.pl $(DESTDIR)$(MAN_DIR)/man1/gendesc.1 $(VERSION) $(RELEASE) $(FULL)
-	bin/updateversion.pl $(DESTDIR)$(MAN_DIR)/man5/lcovrc.5 $(VERSION) $(RELEASE) $(FULL)
-
-uninstall:
-	bin/install.sh --uninstall bin/lcov $(DESTDIR)$(BIN_DIR)/lcov
-	bin/install.sh --uninstall bin/genhtml $(DESTDIR)$(BIN_DIR)/genhtml
-	bin/install.sh --uninstall bin/geninfo $(DESTDIR)$(BIN_DIR)/geninfo
-	bin/install.sh --uninstall bin/genpng $(DESTDIR)$(BIN_DIR)/genpng
-	bin/install.sh --uninstall bin/gendesc $(DESTDIR)$(BIN_DIR)/gendesc
-	bin/install.sh --uninstall man/lcov.1 $(DESTDIR)$(MAN_DIR)/man1/lcov.1
-	bin/install.sh --uninstall man/genhtml.1 $(DESTDIR)$(MAN_DIR)/man1/genhtml.1
-	bin/install.sh --uninstall man/geninfo.1 $(DESTDIR)$(MAN_DIR)/man1/geninfo.1
-	bin/install.sh --uninstall man/genpng.1 $(DESTDIR)$(MAN_DIR)/man1/genpng.1
-	bin/install.sh --uninstall man/gendesc.1 $(DESTDIR)$(MAN_DIR)/man1/gendesc.1
-	bin/install.sh --uninstall man/lcovrc.5 $(DESTDIR)$(MAN_DIR)/man5/lcovrc.5
-	bin/install.sh --uninstall lcovrc $(DESTDIR)$(CFG_DIR)/lcovrc
-
-dist: lcov-$(VERSION).tar.gz lcov-$(VERSION)-$(RELEASE).noarch.rpm \
-      lcov-$(VERSION)-$(RELEASE).src.rpm
-
-lcov-$(VERSION).tar.gz: $(FILES)
-	mkdir $(TMP_DIR)/lcov-$(VERSION)
-	cp -r * $(TMP_DIR)/lcov-$(VERSION)
-	bin/copy_dates.sh . $(TMP_DIR)/lcov-$(VERSION)
-	make -C $(TMP_DIR)/lcov-$(VERSION) clean
-	bin/updateversion.pl $(TMP_DIR)/lcov-$(VERSION) $(VERSION) $(RELEASE) $(FULL)
-	bin/get_changes.sh > $(TMP_DIR)/lcov-$(VERSION)/CHANGES
-	cd $(TMP_DIR) ; \
-	tar cfz $(TMP_DIR)/lcov-$(VERSION).tar.gz lcov-$(VERSION)
-	mv $(TMP_DIR)/lcov-$(VERSION).tar.gz .
-	rm -rf $(TMP_DIR)
-
-lcov-$(VERSION)-$(RELEASE).noarch.rpm: rpms
-lcov-$(VERSION)-$(RELEASE).src.rpm: rpms
-
-rpms: lcov-$(VERSION).tar.gz
-	mkdir $(TMP_DIR)
-	mkdir $(TMP_DIR)/BUILD
-	mkdir $(TMP_DIR)/RPMS
-	mkdir $(TMP_DIR)/SOURCES
-	mkdir $(TMP_DIR)/SRPMS
-	cp lcov-$(VERSION).tar.gz $(TMP_DIR)/SOURCES
-	cd $(TMP_DIR)/BUILD ; \
-	tar xfz $(TMP_DIR)/SOURCES/lcov-$(VERSION).tar.gz \
-		lcov-$(VERSION)/rpm/lcov.spec
-	rpmbuild --define '_topdir $(TMP_DIR)' \
-		 -ba $(TMP_DIR)/BUILD/lcov-$(VERSION)/rpm/lcov.spec
-	mv $(TMP_DIR)/RPMS/noarch/lcov-$(VERSION)-$(RELEASE).noarch.rpm .
-	mv $(TMP_DIR)/SRPMS/lcov-$(VERSION)-$(RELEASE).src.rpm .
-	rm -rf $(TMP_DIR)
-
-test:
-	@make -C test -s all

externals/lcov/README

--------------------------------------------------
-- README file for the LTP GCOV extension (LCOV) -
-- Last changes: 2019-02-28                      -
--------------------------------------------------
-
-Description
------------
-  LCOV is an extension of GCOV, a GNU tool which provides information about
-  what parts of a program are actually executed (i.e. "covered") while running
-  a particular test case. The extension consists of a set of Perl scripts
-  which build on the textual GCOV output to implement the following enhanced
-  functionality:
-
-    * HTML based output: coverage rates are additionally indicated using bar
-      graphs and specific colors.
-
-    * Support for large projects: overview pages allow quick browsing of
-      coverage data by providing three levels of detail: directory view,
-      file view and source code view.
-
-  LCOV was initially designed to support Linux kernel coverage measurements,
-  but works as well for coverage measurements on standard user space
-  applications.
-
-
-Further README contents
------------------------
-  1. Included files
-  2. Installing LCOV
-  3. An example of how to access kernel coverage data
-  4. An example of how to access coverage data for a user space program
-  5. Questions and Comments
-
-
-
-1. Important files
-------------------
-  README             - This README file
-  CHANGES            - List of changes between releases
-  bin/lcov           - Tool for capturing LCOV coverage data
-  bin/genhtml        - Tool for creating HTML output from LCOV data
-  bin/gendesc        - Tool for creating description files as used by genhtml
-  bin/geninfo        - Internal tool (creates LCOV data files)
-  bin/genpng         - Internal tool (creates png overviews of source files)
-  bin/install.sh     - Internal tool (takes care of un-/installing)
-  man                - Directory containing man pages for included tools
-  example            - Directory containing an example to demonstrate LCOV
-  lcovrc             - LCOV configuration file
-  Makefile           - Makefile providing 'install' and 'uninstall' targets
-
-
-2. Installing LCOV
-------------------
-The LCOV package is available as either RPM or tarball from:
-     
-  http://ltp.sourceforge.net/coverage/lcov.php
-
-To install the tarball, unpack it to a directory and run:
-
-  make install
-
-Use Git for the most recent (but possibly unstable) version:
-
-  git clone https://github.com/linux-test-project/lcov.git
-
-Change to the resulting lcov directory and type:
-
-  make install
-
-
-3. An example of how to access kernel coverage data
----------------------------------------------------
-Requirements: get and install the gcov-kernel package from
-
-  http://sourceforge.net/projects/ltp
-
-Copy the resulting gcov kernel module file to either the system wide modules
-directory or the same directory as the Perl scripts. As root, do the following:
-
-  a) Resetting counters
-
-     lcov --zerocounters
-
-  b) Capturing the current coverage state to a file
-
-     lcov --capture --output-file kernel.info
-
-  c) Getting HTML output
-
-     genhtml kernel.info
-
-Point the web browser of your choice to the resulting index.html file.
-
-
-4. An example of how to access coverage data for a user space program
----------------------------------------------------------------------
-Requirements: compile the program in question using GCC with the options
--fprofile-arcs and -ftest-coverage. During linking, make sure to specify
--lgcov or -coverage.
-
-Assuming the compile directory is called "appdir", do the following:
-
-  a) Resetting counters
-
-     lcov --directory appdir --zerocounters
-
-  b) Capturing the current coverage state to a file
-
-     lcov --directory appdir --capture --output-file app.info
-
-     Note that this step only works after the application has
-     been started and stopped at least once. Otherwise lcov will
-     abort with an error mentioning that there are no data/.gcda files.
-
-  c) Getting HTML output
-
-     genhtml app.info
-
-Point the web browser of your choice to the resulting index.html file.
-
-Please note that independently of where the application is installed or
-from which directory it is run, the --directory statement needs to
-point to the directory in which the application was compiled.
-
-For further information on the gcc profiling mechanism, please also
-consult the gcov man page.
-
-
-5. Questions and comments
--------------------------
-See the included man pages for more information on how to use the LCOV tools.
-
-Please email further questions or comments regarding this tool to the
-LTP Mailing list at ltp-coverage@lists.sourceforge.net  
-

externals/lcov/bin/copy_dates.sh

-#!/usr/bin/env bash
-#
-# Usage: copy_dates.sh SOURCE TARGET
-#
-# For each file found in SOURCE, set the modification time of the copy of that
-# file in TARGET to either the time of the latest Git commit (if SOURCE contains
-# a Git repository and the file was not modified after the last commit), or the
-# modification time of the original file.
-
-SOURCE="$1"
-TARGET="$2"
-
-if [ -z "$SOURCE" -o -z "$TARGET" ] ; then
-	echo "Usage: $0 SOURCE TARGET" >&2
-	exit 1
-fi
-
-[ -d "$SOURCE/.git" ] ; NOGIT=$?
-
-echo "Copying modification/commit times from $SOURCE to $TARGET"
-
-cd "$SOURCE" || exit 1
-find * -type f | while read FILENAME ; do
-	[ ! -e "$TARGET/$FILENAME" ] && continue
-
-	# Copy modification time
-	touch -m "$TARGET/$FILENAME" -r "$FILENAME"
-
-	[ $NOGIT -eq 1 ] && continue				# No Git
-	git diff --quiet -- "$FILENAME" || continue		# Modified
-	git diff --quiet --cached -- "$FILENAME" || continue	# Modified
-
-	# Apply modification time from Git commit time
-	TIME=$(git log --pretty=format:%cd -n 1 --date=iso -- "$FILENAME")
-	[ -n "$TIME" ] && touch -m "$TARGET/$FILENAME" --date "$TIME"
-done

externals/lcov/bin/gendesc

-#!/usr/bin/env perl
-#
-#   Copyright (c) International Business Machines  Corp., 2002
-#
-#   This program is free software;  you can redistribute it and/or modify
-#   it under the terms of the GNU General Public License as published by
-#   the Free Software Foundation; either version 2 of the License, or (at
-#   your option) any later version.
-#
-#   This program is distributed in the hope that it will be useful, but
-#   WITHOUT ANY WARRANTY;  without even the implied warranty of
-#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-#   General Public License for more details.                 
-#
-#   You should have received a copy of the GNU General Public License
-#   along with this program;  if not, write to the Free Software
-#   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-#
-#
-# gendesc
-#
-#   This script creates a description file as understood by genhtml.
-#   Input file format:
-#
-#   For each test case:
-#     <test name><optional whitespace>
-#     <at least one whitespace character (blank/tab)><test description>
-#   
-#   Actual description may consist of several lines. By default, output is
-#   written to stdout. Test names consist of alphanumeric characters
-#   including _ and -.
-#
-#
-# History:
-#   2002-09-02: created by Peter Oberparleiter <Peter.Oberparleiter@de.ibm.com>
-#
-
-use strict;
-use warnings;
-use File::Basename; 
-use Getopt::Long;
-use Cwd qw/abs_path/;
-
-
-# Constants
-our $tool_dir		= abs_path(dirname($0));
-our $lcov_version	= "LCOV version 1.14";
-our $lcov_url		= "http://ltp.sourceforge.net/coverage/lcov.php";
-our $tool_name		= basename($0);
-
-
-# Prototypes
-sub print_usage(*);
-sub gen_desc();
-sub warn_handler($);
-sub die_handler($);
-
-
-# Global variables
-our $help;
-our $version;
-our $output_filename;
-our $input_filename;
-
-
-#
-# Code entry point
-#
-
-$SIG{__WARN__} = \&warn_handler;
-$SIG{__DIE__} = \&die_handler;
-
-# Parse command line options
-if (!GetOptions("output-filename=s" => \$output_filename,
-		"version" =>\$version,
-		"help|?" => \$help
-		))
-{
-	print(STDERR "Use $tool_name --help to get usage information\n");
-	exit(1);
-}
-
-$input_filename = $ARGV[0];
-
-# Check for help option
-if ($help)
-{
-	print_usage(*STDOUT);
-	exit(0);
-}
-
-# Check for version option
-if ($version)
-{
-	print("$tool_name: $lcov_version\n");
-	exit(0);
-}
-
-
-# Check for input filename
-if (!$input_filename)
-{
-	die("No input filename specified\n".
-	    "Use $tool_name --help to get usage information\n");
-}
-
-# Do something
-gen_desc();
-
-
-#
-# print_usage(handle)
-#
-# Write out command line usage information to given filehandle.
-#
-
-sub print_usage(*)
-{
-	local *HANDLE = $_[0];
-
-	print(HANDLE <<END_OF_USAGE)
-Usage: $tool_name [OPTIONS] INPUTFILE
-
-Convert a test case description file into a format as understood by genhtml.
-
-  -h, --help                        Print this help, then exit
-  -v, --version                     Print version number, then exit
-  -o, --output-filename FILENAME    Write description to FILENAME
-
-For more information see: $lcov_url
-END_OF_USAGE
-	;
-}
-
-
-#
-# gen_desc()
-#
-# Read text file INPUT_FILENAME and convert the contained description to a
-# format as understood by genhtml, i.e.
-#
-#    TN:<test name>
-#    TD:<test description>
-#
-# If defined, write output to OUTPUT_FILENAME, otherwise to stdout.
-#
-# Die on error.
-#
-
-sub gen_desc()
-{
-	local *INPUT_HANDLE;
-	local *OUTPUT_HANDLE;
-	my $empty_line = "ignore";
-
-	open(INPUT_HANDLE, "<", $input_filename)
-		or die("ERROR: cannot open $input_filename!\n");
-
-	# Open output file for writing
-	if ($output_filename)
-	{
-		open(OUTPUT_HANDLE, ">", $output_filename)
-			or die("ERROR: cannot create $output_filename!\n");
-	}
-	else
-	{
-		*OUTPUT_HANDLE = *STDOUT;
-	}
-
-	# Process all lines in input file
-	while (<INPUT_HANDLE>)
-	{
-		chomp($_);
-
-		if (/^(\w[\w-]*)(\s*)$/)
-		{
-			# Matched test name
-			# Name starts with alphanum or _, continues with
-			# alphanum, _ or -
-			print(OUTPUT_HANDLE "TN: $1\n");
-			$empty_line = "ignore";
-		}
-		elsif (/^(\s+)(\S.*?)\s*$/)
-		{
-			# Matched test description
-			if ($empty_line eq "insert")
-			{
-				# Write preserved empty line
-				print(OUTPUT_HANDLE "TD: \n");
-			}
-			print(OUTPUT_HANDLE "TD: $2\n");
-			$empty_line = "observe";
-		}
-		elsif (/^\s*$/)
-		{
-			# Matched empty line to preserve paragraph separation
-			# inside description text
-			if ($empty_line eq "observe")
-			{
-				$empty_line = "insert";
-			}
-		}
-	}
-
-	# Close output file if defined
-	if ($output_filename)
-	{
-		close(OUTPUT_HANDLE);
-	}
-
-	close(INPUT_HANDLE);
-}
-
-sub warn_handler($)
-{
-	my ($msg) = @_;
-
-	warn("$tool_name: $msg");
-}
-
-sub die_handler($)
-{
-	my ($msg) = @_;
-
-	die("$tool_name: $msg");
-}