From b2c52384b0654a593d854665de23e8322c7ac9c4 Mon Sep 17 00:00:00 2001
From: Christian Zimmermann <christian.zimmermann@ur.de>
Date: Sat, 3 Feb 2024 01:22:52 +0100
Subject: [PATCH 1/9] README: expressions and operations section (WIP)

---
 README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)

diff --git a/README.md b/README.md
index 19c0247..3cfb608 100644
--- a/README.md
+++ b/README.md
@@ -72,5 +72,75 @@ Finally, there are the container classes (arrays), which are derived from `CArra
 
 #### Expressions and Operations
 
+In the context of this library, *expressions* are classes representing an expression that is supposed to be executed at given points during an iteration proceedure that involves one or more indexed quantities. Each expression type must fulfill the following requirements:
+
+* There must be an implementation of `operator()` taking a multi-position argument indicating the position for the current iteration of each involved object according to its indices. The function can have an expression defined return value, which can be further processed.
+
+* There must be an implementation of `rootSteps()` taking an index ID as argument. The function should return jump sizes for each involved object corresponding to the given index.
+
+Each expression `Xpr` should be derived from the class `XprInterface<Xpr>`, where `Xpr` is a recurring template argument (static polymorphism).
+
+There are two important expression types:
+
+* *For* expressions: They represent a for loop over a given index.
+
+* *Operations*: They correspond to one or more indexed array types and given operation on or between them. If an operation handles nothing but the access to one single array, it is called *Operation* *Root*. 
+
+Example:
+```cpp
+#include "cnroxz.h"
+
+using namespace CNORZX;
+
+RangePtr r = CRangeFactory(3).create(); // [0,1,2]
+RangePtr s = CRangeFactory(5).create(); // [0,1,2,3,4]
+RangePtr t = URangeFactory<Int>(Vector<Int>{4,5,6}).create(); // [4,5,6]
+i = std::make_shared<CIndex>(r);
+j = std::make_shared<CIndex>(s);
+k = std::make_shared<UIndex<Int>>(t);
+
+MArray<Double> a(r*s*t); // 3-dim array, dimensions = [3,5,3], size = 45
+MArray<Double> b(r*t); // 2-dim array, dimensions = [3,3], size = 9
+MArray<Double> c(s*t); // 2-dim array, dimensions = [3,5], size = 15
+
+// set array element values of a,b,c here...
+
+c(j*k) += ( a(i*j*k) * b(j*k) * xpr(k) ).c(i);
+
+/* Explanation of the above line:
+
+c(j*k), a(i*j*k), b(j*k) and xpr(k) are operation roots, i.e.
+they manage access to the arrays c,a,b and the meta data space of index k
+
+The operations between the operation roots are also operations in the
+sense of this nomenclature, i.e. a(i*j*k) * b(j*k) is again an operation.
+
+The operation member function c() creates contraction, i.e. a for loop
+over the given index (i). If no further functions are specified, the values
+returned by the underlying operations are summed up for equivalent index
+combinations.
+
+The += invokes a for loop over the indices on the l.h.s.. The values returned
+by the expression on the r.h.s. are added to the l.h.s. Something similar could be done
+with a = operator. Then the values would just be assigned instead of added.
+
+*/
+
+// Equivalent C-stype for loop (if a,b,c were C-style arrays):
+
+for(size_t j = 0; j < s; ++j){
+	for(size_t k = 0; k < t; ++k){
+		int kv = k+4;
+		double x = 0;
+		// the contraction part:
+		for(size_t i = 0; i < r; ++i){
+			 x += a[i*s*t+j*t+k] * b[j*t+k] * kv;
+		}
+		c[j*t+k] += x;
+	}
+}
+
+```
+
 ...
 
-- 
2.45.2


From 871910355d36032dce0e39c4f5a72fd84e967a0c Mon Sep 17 00:00:00 2001
From: Christian Zimmermann <christian.zimmermann@ur.de>
Date: Sat, 3 Feb 2024 16:44:34 +0100
Subject: [PATCH 2/9] cereal documentation

---
 src/include/memory/allocator.cc.h             |  10 ++
 src/include/memory/allocator.h                |   7 +-
 src/include/operation/basic_operations.cc.h   |  10 ++
 src/include/operation/basic_operations.h      |  10 ++
 src/opt/cereal/include/cer_array.cc.h         |  11 +-
 src/opt/cereal/include/cer_base.h             |  18 ++-
 src/opt/cereal/include/cer_header.cc.h        |  10 ++
 src/opt/cereal/include/cer_header.h           |  34 +++++-
 src/opt/cereal/include/cer_ranges.cc.h        |  10 ++
 src/opt/cereal/include/cer_type_register.cc.h |  10 ++
 src/opt/cereal/include/cnorxz_cereal.h        |  10 ++
 src/opt/cereal/include/range_save_load.cc.h   |  10 ++
 src/opt/cereal/include/range_save_load.h      |  20 +++-
 src/opt/cereal/include/utilities.cc.h         |  10 ++
 src/opt/cereal/include/utilities.h            | 109 +++++++++++++++---
 src/opt/hdf5/lib/h5_group.cc                  |   2 +
 src/tests/test_numbers.h                      |   2 +
 17 files changed, 268 insertions(+), 25 deletions(-)

diff --git a/src/include/memory/allocator.cc.h b/src/include/memory/allocator.cc.h
index 352eb9c..2e50105 100644
--- a/src/include/memory/allocator.cc.h
+++ b/src/include/memory/allocator.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/memory/allocator.cc.h
+   @brief Allocator template member function implementation
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_allocator_cc_h__
 #define __cxz_allocator_cc_h__
diff --git a/src/include/memory/allocator.h b/src/include/memory/allocator.h
index 92be7f3..bc90139 100644
--- a/src/include/memory/allocator.h
+++ b/src/include/memory/allocator.h
@@ -1,11 +1,10 @@
 // -*- C++ -*-
 /**
    
-   @file include/memory/memcount.h
-   @brief ...
+   @file include/memory/allocator.h
+   @brief Allocator declaration
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/operation/basic_operations.cc.h b/src/include/operation/basic_operations.cc.h
index 9e8d3b5..df23e01 100644
--- a/src/include/operation/basic_operations.cc.h
+++ b/src/include/operation/basic_operations.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file include/operation/basic_operations.cc.h
+   @brief Basic operations implementation
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+ **/
 
 #ifndef __cxz_basic_operations_cc_h__
 #define __cxz_basic_operations_cc_h__
diff --git a/src/include/operation/basic_operations.h b/src/include/operation/basic_operations.h
index 150e183..8301fbe 100644
--- a/src/include/operation/basic_operations.h
+++ b/src/include/operation/basic_operations.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file include/operation/basic_operations.h
+   @brief Basic operations declaration
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+ **/
 
 #ifndef __cxz_basic_operations_h__
 #define __cxz_basic_operations_h__
diff --git a/src/opt/cereal/include/cer_array.cc.h b/src/opt/cereal/include/cer_array.cc.h
index 35f5c6d..076c658 100644
--- a/src/opt/cereal/include/cer_array.cc.h
+++ b/src/opt/cereal/include/cer_array.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/cereal/include/cer_array.cc.h
+   @brief Load and save implementation for MArray.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #ifndef __cxz_cereal_array_cc_h__
 #define __cxz_cereal_array_cc_h__
@@ -23,7 +33,6 @@ namespace CNORXZ
     {
 	CXZ_ASSERT(version == 1u, "format version = " << version << " not supported");
 	cer::save_load(ar, "range", AB::mRange);
-	//ar(cereal::make_nvp("range", AB::mRange));
 	ar(cereal::make_nvp("data", mCont));
     }
 }
diff --git a/src/opt/cereal/include/cer_base.h b/src/opt/cereal/include/cer_base.h
index 97710f9..127de76 100644
--- a/src/opt/cereal/include/cer_base.h
+++ b/src/opt/cereal/include/cer_base.h
@@ -1,19 +1,35 @@
+// -*- C++ -*-
+/**
+
+   @file opt/cereal/include/cer_base.h
+   @brief CNORXZ Cereal basic types declaration.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #ifndef __cxz_cer_base_h__
 #define __cxz_cer_base_h__
 
-#define CXZ_CEREAL_FORMAT_VERION 1u
+#define CXZ_CEREAL_FORMAT_VERION 1u /**< CNORXZ specific cereal format version. */
 
 namespace CNORXZ
 {
     namespace cer
     {
+	/** ****
+	    Archive format enum class.
+	 */
 	enum class Format {
 	    BINARY = 1u,
 	    JSON = 2u,
 	    XML = 3u
 	};
 	
+	/** ****
+	    Content type enum class.
+	 */
 	enum class ContentType {
 	    ARRAY = 1u,
 	    MAP = 2u
diff --git a/src/opt/cereal/include/cer_header.cc.h b/src/opt/cereal/include/cer_header.cc.h
index 64dcd2a..408cfd9 100644
--- a/src/opt/cereal/include/cer_header.cc.h
+++ b/src/opt/cereal/include/cer_header.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/cereal/include/cer_header.cc.h
+   @brief Load and save implementation for CNORXZ cereal data header.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #ifndef __cxz_cereal_header_cc_h__
 #define __cxz_cereal_header_cc_h__
diff --git a/src/opt/cereal/include/cer_header.h b/src/opt/cereal/include/cer_header.h
index be677a1..946c2a8 100644
--- a/src/opt/cereal/include/cer_header.h
+++ b/src/opt/cereal/include/cer_header.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/cereal/include/cer_header.h
+   @brief CNORXZ Cereal data header declaration.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #ifndef __cxz_cereal_header_h__
 #define __cxz_cereal_header_h__
@@ -9,13 +19,19 @@ namespace CNORXZ
 {
     namespace cer
     {
+	/** ****
+	    Cereal data header struct.
+	 */
 	struct Header
 	{
-	    String version;
-	    String commit;
-	    ContentType content;
+	    String version; /**< CNORXZ version. */
+	    String commit; /**< CNORXZ git commit. */
+	    ContentType content; /**< Content type. */
 	};
 
+	/** Create header.
+	    @param content Content type.
+	 */
 	inline Header mkHeader(const ContentType content)
 	{
 	    Header o;
@@ -24,10 +40,20 @@ namespace CNORXZ
 	    o.content = content;
 	    return o;
 	}
-	
+
+	/** Serialze header, store in archive.
+	    @param ar Target archive.
+	    @param h Input header.
+	    @param version Version.
+	 */
 	template <class Archive>
 	void save(Archive& ar, const Header& h, const std::uint32_t version);
 
+	/** Deserialze header from archive.
+	    @param ar Source archive.
+	    @param h Target header reference.
+	    @param version Version.
+	 */
 	template <class Archive>
 	void load(Archive& ar, Header& h, const std::uint32_t version);
 
diff --git a/src/opt/cereal/include/cer_ranges.cc.h b/src/opt/cereal/include/cer_ranges.cc.h
index ea2748e..7180e99 100644
--- a/src/opt/cereal/include/cer_ranges.cc.h
+++ b/src/opt/cereal/include/cer_ranges.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/cereal/include/cer_ranges.cc.h
+   @brief Load and save implementation for cnorxz ranges.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #ifndef __cxz_cereal_ranges_cc_h__
 #define __cxz_cereal_ranges_cc_h__
diff --git a/src/opt/cereal/include/cer_type_register.cc.h b/src/opt/cereal/include/cer_type_register.cc.h
index 7e4ae5c..4c3ba4f 100644
--- a/src/opt/cereal/include/cer_type_register.cc.h
+++ b/src/opt/cereal/include/cer_type_register.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/cereal/include/cer_type_register.cc.h
+   @brief Register CNORXZ cereal types.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #ifndef __cxz_cereal_type_register_cc_h__
 #define __cxz_cereal_type_register_cc_h__
diff --git a/src/opt/cereal/include/cnorxz_cereal.h b/src/opt/cereal/include/cnorxz_cereal.h
index 5d58780..d7410c2 100644
--- a/src/opt/cereal/include/cnorxz_cereal.h
+++ b/src/opt/cereal/include/cnorxz_cereal.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/cereal/include/cnorxz_cereal.h
+   @brief CNORXZ Cereal main header
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #include "cer_base.h"
 #include "cer_header.h"
diff --git a/src/opt/cereal/include/range_save_load.cc.h b/src/opt/cereal/include/range_save_load.cc.h
index db6917c..e568257 100644
--- a/src/opt/cereal/include/range_save_load.cc.h
+++ b/src/opt/cereal/include/range_save_load.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/cereal/include/range_save_load.cc.h
+   @brief CNORXZ Cereal range save load implementation.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #ifndef __range_save_load_cc_h__
 #define __range_save_load_cc_h__
diff --git a/src/opt/cereal/include/range_save_load.h b/src/opt/cereal/include/range_save_load.h
index a60f0f6..5ef60bc 100644
--- a/src/opt/cereal/include/range_save_load.h
+++ b/src/opt/cereal/include/range_save_load.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/cereal/include/range_save_load.h
+   @brief CNORXZ Cereal range save load declaration.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #ifndef __range_save_load_h__
 #define __range_save_load_h__
@@ -8,8 +18,14 @@ namespace CNORXZ
 {
     namespace cer
     {
-	// use this function to register the range in the map of the range factories
-	// (otherwise there might be more than one instance of the same range)
+	/** Deserialize and register range from cereal archive.
+	    Always use this function to load ranges from archives so that it is
+	    registered in the map of the range factories. Otherwise there might be more
+	    than one instance of the same range.
+	    @param ar Archive to read from.
+	    @param name Archive key.
+	    @param r Target range pointer.
+	*/
 	template <class Archive>
 	RangePtr save_load(Archive& ar, const String& name, RangePtr& r);
     }
diff --git a/src/opt/cereal/include/utilities.cc.h b/src/opt/cereal/include/utilities.cc.h
index 790d3ae..678231d 100644
--- a/src/opt/cereal/include/utilities.cc.h
+++ b/src/opt/cereal/include/utilities.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/cereal/include/utilities.cc.h
+   @brief CNORXZ Cereal utilities implementation.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #ifndef __cxz_cereal_utilities_cc_h__
 #define __cxz_cereal_utilities_cc_h__
diff --git a/src/opt/cereal/include/utilities.h b/src/opt/cereal/include/utilities.h
index e8e8750..6a7a0bf 100644
--- a/src/opt/cereal/include/utilities.h
+++ b/src/opt/cereal/include/utilities.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/cereal/include/utilities.h
+   @brief CNORXZ Cereal utilities declaration.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #ifndef __cxz_cereal_utilities_h__
 #define __cxz_cereal_utilities_h__
@@ -14,68 +24,141 @@ namespace CNORXZ
 {
     namespace cer
     {
-
+	/** ****
+	    Output archive type trait.
+	    @tparam F Format enum.
+	 */
 	template <Format F>
 	struct OutputFormatMap
 	{};
 
+	/** Output archive for binary format. */
 	template <>
 	struct OutputFormatMap<Format::BINARY>
-	{ typedef cereal::BinaryOutputArchive type; };
+	{ typedef cereal::BinaryOutputArchive type; /**< archive type. */ };
 
+	/** Output archive for json format. */
 	template <>
 	struct OutputFormatMap<Format::JSON>
-	{ typedef cereal::JSONOutputArchive type; };
+	{ typedef cereal::JSONOutputArchive type; /**< archive type. */ };
 
+	/** Output archive for xml format. */
 	template <>
 	struct OutputFormatMap<Format::XML>
-	{ typedef cereal::XMLOutputArchive type; };
+	{ typedef cereal::XMLOutputArchive type; /**< archive type. */ };
 
+	/** ****
+	    Input archive type trait.
+	    @tparam F Format enum.
+	 */
 	template <Format F>
 	struct InputFormatMap
 	{};
 
+	/** Input archive for binary format. */
 	template <>
 	struct InputFormatMap<Format::BINARY>
-	{ typedef cereal::BinaryInputArchive type; };
+	{ typedef cereal::BinaryInputArchive type; /**< archive type. */ };
 
+	/** Input archive for json format. */
 	template <>
 	struct InputFormatMap<Format::JSON>
-	{ typedef cereal::JSONInputArchive type; };
+	{ typedef cereal::JSONInputArchive type; /**< archive type. */ };
 
+	/** Input archive for xml format. */
 	template <>
 	struct InputFormatMap<Format::XML>
-	{ typedef cereal::XMLInputArchive type; };
+	{ typedef cereal::XMLInputArchive type; /**< archive type. */ };
 
+	/** Serialize MArray to stream
+	    @tparam F Format enum class [BINARY,JSON,XML].
+	    @tparam T Array element value type.
+	    @param os Output stream.
+	    @param data Array to be serialized.
+	 */
     	template <Format F, typename T>
 	void write(std::ostream& os, const MArray<T>& data);
 
+	/** Deserialize MArray from stream
+	    @tparam F Format enum class [BINARY,JSON,XML].
+	    @tparam T Array element value type.
+	    @param is Input stream.
+	    @param data Target array.
+	 */
     	template <Format F, typename T>
 	void read(std::istream& is, MArray<T>& data);
 
+	/** Serialize MArray and write to file.
+	    @tparam F Format enum class [BINARY,JSON,XML].
+	    @tparam T Array element value type.
+	    @param name File name.
+	    @param data Array to be saved.
+	 */
     	template <Format F, typename T>
 	void writeFile(const String& name, const MArray<T>& data);
 
+	/** Read and deserialize MArray from cereal compatibel file.
+	    @tparam F Format enum class [BINARY,JSON,XML].
+	    @tparam T Array element value type.
+	    @param name File name.
+	    @param data target array.
+	 */
     	template <Format F, typename T>
 	void readFile(const String& name, MArray<T>& data);
 
+	/** Serialize MArray and write to binary file.
+	    @tparam T Array element value type.
+	    @param name File name.
+	    @param data Array to be saved.
+	 */
 	template <typename T>
-	void writeBINARYFile(const String& name, const MArray<T>& data) { writeFile<Format::BINARY>(name, data); }
+	inline void writeBINARYFile(const String& name, const MArray<T>& data)
+	{ writeFile<Format::BINARY>(name, data); }
 
+	/** Read and deserialize MArray from cereal compatibel binary file.
+	    @tparam T Array element value type.
+	    @param name File name.
+	    @param data target array.
+	 */
     	template <typename T>
-	void readBINARYFile(const String& name, MArray<T>& data) { readFile<Format::BINARY>(name, data); }
+	inline void readBINARYFile(const String& name, MArray<T>& data)
+	{ readFile<Format::BINARY>(name, data); }
 
+	/** Serialize MArray and write to json file.
+	    @tparam T Array element value type.
+	    @param name File name.
+	    @param data Array to be saved.
+	 */
 	template <typename T>
-	void writeJSONFile(const String& name, const MArray<T>& data) { writeFile<Format::JSON>(name, data); }
+	inline void writeJSONFile(const String& name, const MArray<T>& data)
+	{ writeFile<Format::JSON>(name, data); }
 
+	/** Read and deserialize MArray from cereal compatibel json file.
+	    @tparam T Array element value type.
+	    @param name File name.
+	    @param data target array.
+	 */
     	template <typename T>
-	void readJSONFile(const String& name, MArray<T>& data) { readFile<Format::JSON>(name, data); }
+	inline void readJSONFile(const String& name, MArray<T>& data)
+	{ readFile<Format::JSON>(name, data); }
 
+	/** Serialize MArray and write to xml file.
+	    @tparam T Array element value type.
+	    @param name File name.
+	    @param data Array to be saved.
+	 */
 	template <typename T>
-	void writeXMLFile(const String& name, const MArray<T>& data) { writeFile<Format::XML>(name, data); }
+	inline void writeXMLFile(const String& name, const MArray<T>& data)
+	{ writeFile<Format::XML>(name, data); }
 
+	/** Read and deserialize MArray from cereal compatibel xml file.
+	    @tparam T Array element value type.
+	    @param name File name.
+	    @param data target array.
+	 */
     	template <typename T>
-	void readXMLFile(const String& name, MArray<T>& data) { readFile<Format::XML>(name, data); }
+	inline void readXMLFile(const String& name, MArray<T>& data)
+	{ readFile<Format::XML>(name, data); }
     }
 }
 
diff --git a/src/opt/hdf5/lib/h5_group.cc b/src/opt/hdf5/lib/h5_group.cc
index 7728b95..a5d093f 100644
--- a/src/opt/hdf5/lib/h5_group.cc
+++ b/src/opt/hdf5/lib/h5_group.cc
@@ -133,11 +133,13 @@ namespace CNORXZ
 	    return *this;
 	}
 
+	/** @cond 0 */
 	struct InitContData
 	{
 	    const ContentBase* parent;
 	    BIndex<ContentPtr> index;
 	};
+	/** @endcond */
 
 	static herr_t addName(hid_t id, const char* name, const H5L_info_t* info, void* x)
 	{
diff --git a/src/tests/test_numbers.h b/src/tests/test_numbers.h
index 2a66357..0d4e52a 100644
--- a/src/tests/test_numbers.h
+++ b/src/tests/test_numbers.h
@@ -11,6 +11,7 @@ namespace CNORXZ
 {
     namespace Test
     {
+	/** @cond 0 */
 	class Numbers
 	{
 	private:
@@ -51,6 +52,7 @@ namespace CNORXZ
 		return Vector<Double>(b,e);
 	    }
 	};
+	/** @endcond */
     }
 }
 
-- 
2.45.2


From 5eff4cfe3fda99795c0e64b43fb949c6df627061 Mon Sep 17 00:00:00 2001
From: Christian Zimmermann <christian.zimmermann@ur.de>
Date: Sat, 3 Feb 2024 18:35:13 +0100
Subject: [PATCH 3/9] improve doxygen setup

---
 README.md                       |   4 +++-
 doc/doxy/Doxyfile               |  12 +++++------
 doc/doxy/cnorxz_logo_mini.png   | Bin 0 -> 5562 bytes
 doc/doxy/header.html            |  36 ++++++++++++++++++++++++++++++++
 src/include/ranges/index_base.h |   2 +-
 5 files changed, 46 insertions(+), 8 deletions(-)
 create mode 100644 doc/doxy/cnorxz_logo_mini.png
 create mode 100644 doc/doxy/header.html

diff --git a/README.md b/README.md
index 3cfb608..3ff29bd 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,6 @@
-# Container with Native Operation Routines by XZ (CNORXZ)
+# Container with Native Operation Routines and Expressions (CNORXZ)
+
+(as always, the name was there before the acronym)
 
 ![Image](./cnorxz_logo.png)
 
diff --git a/doc/doxy/Doxyfile b/doc/doxy/Doxyfile
index d54e1f3..38e3958 100644
--- a/doc/doxy/Doxyfile
+++ b/doc/doxy/Doxyfile
@@ -54,14 +54,14 @@ PROJECT_NUMBER         =
 # for a project that appears at the top of each page and should give viewer a
 # quick idea about the purpose of the project. Keep the description short.
 
-PROJECT_BRIEF          = "Container with Native Operation Routines (by XZ)"
+PROJECT_BRIEF          = "Container with Native Operation Routines and Expressions"
 
 # With the PROJECT_LOGO tag one can specify a logo or an icon that is included
 # in the documentation. The maximum height of the logo should not exceed 55
 # pixels and the maximum width should not exceed 200 pixels. Doxygen will copy
 # the logo to the output directory.
 
-PROJECT_LOGO           =
+PROJECT_LOGO           = "cnorxz_logo_mini.png"
 
 # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path
 # into which the generated documentation will be written. If a relative path is
@@ -518,7 +518,7 @@ TIMESTAMP              = NO
 # normally produced when WARNINGS is set to YES.
 # The default value is: NO.
 
-EXTRACT_ALL            = NO
+EXTRACT_ALL            = YES
 
 # If the EXTRACT_PRIVATE tag is set to YES, all private members of a class will
 # be included in the documentation.
@@ -542,7 +542,7 @@ EXTRACT_PACKAGE        = NO
 # included in the documentation.
 # The default value is: NO.
 
-EXTRACT_STATIC         = NO
+EXTRACT_STATIC         = YES
 
 # If the EXTRACT_LOCAL_CLASSES tag is set to YES, classes (and structs) defined
 # locally in source files will be included in the documentation. If set to NO,
@@ -1269,7 +1269,7 @@ HTML_FILE_EXTENSION    = .html
 # of the possible markers and block names see the documentation.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_HEADER            =
+HTML_HEADER            = "header.html"
 
 # The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each
 # generated HTML page. If the tag is left blank doxygen will generate a standard
@@ -1319,7 +1319,7 @@ HTML_EXTRA_STYLESHEET  =
 # files will be copied as-is; there are no commands or markers available.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_EXTRA_FILES       =
+HTML_EXTRA_FILES       = "cnorxz_logo_mini.png"
 
 # The HTML_COLORSTYLE tag can be used to specify if the generated HTML output
 # should be rendered with a dark or light theme.
diff --git a/doc/doxy/cnorxz_logo_mini.png b/doc/doxy/cnorxz_logo_mini.png
new file mode 100644
index 0000000000000000000000000000000000000000..9c974fed5d26b8796ecba50a9a5f682907382f50
GIT binary patch
literal 5562
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

literal 0
HcmV?d00001

diff --git a/doc/doxy/header.html b/doc/doxy/header.html
new file mode 100644
index 0000000..8fed2ba
--- /dev/null
+++ b/doc/doxy/header.html
@@ -0,0 +1,36 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<meta http-equiv="X-UA-Compatible" content="IE=11"/>
+<meta name="generator" content="Doxygen 1.10.0"/>
+<meta name="viewport" content="width=device-width, initial-scale=1"/>
+<title>CNORXZ: Container with Native Operation Routines and Expressions (CNORXZ)</title>
+<link href="tabs.css" rel="stylesheet" type="text/css"/>
+<script type="text/javascript" src="jquery.js"></script>
+<script type="text/javascript" src="dynsections.js"></script>
+<script type="text/javascript" src="clipboard.js"></script>
+<script type="text/javascript" src="cookie.js"></script>
+<link href="search/search.css" rel="stylesheet" type="text/css"/>
+<script type="text/javascript" src="search/searchdata.js"></script>
+<script type="text/javascript" src="search/search.js"></script>
+<link href="doxygen.css" rel="stylesheet" type="text/css" />
+</head>
+<link rel="icon" href="$relpath^cnorxz_logo_mini.png" type="image/x-icon" />
+<body>
+<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
+<div id="titlearea">
+<table cellspacing="0" cellpadding="0">
+ <tbody>
+ <tr id="projectrow">
+  <td id="projectlogo"><img alt="Logo" src="cnorxz_logo_mini.png"/></td>
+  <td id="projectalign">
+   <div id="projectname">CNORXZ
+   </div>
+   <div id="projectbrief">Container with Native Operation Routines and Expressions</div>
+  </td>
+ </tr>
+ </tbody>
+</table>
+</div>
+<!-- end header part -->
diff --git a/src/include/ranges/index_base.h b/src/include/ranges/index_base.h
index e13b027..4668af8 100644
--- a/src/include/ranges/index_base.h
+++ b/src/include/ranges/index_base.h
@@ -28,7 +28,7 @@ namespace CNORXZ
 	all indices are supposed to be derived from the corresponding
 	template instance
 
-	Indices are act as iterators over parameter spaces (ranges) and/or
+	Indices act as iterators over parameter spaces (ranges) and/or
 	the containers (arrays) defined on them
 
 	Moreover, indices are used to define operations on the
-- 
2.45.2


From c478bf0fae39f9233d61607a0951e2cf7cdf9cbb Mon Sep 17 00:00:00 2001
From: Christian Zimmermann <christian.zimmermann@ur.de>
Date: Sat, 3 Feb 2024 22:02:01 +0100
Subject: [PATCH 4/9] more documentation + clean up

---
 src/bin/config.cc                             |  10 +
 src/include/array/array.cc.h                  |   5 +-
 src/include/array/array.h                     |   5 +-
 src/include/base/config.h                     |   6 +-
 src/include/base/to_string.h                  |   4 +-
 src/include/base/uuid.h                       |   2 +-
 src/include/cnorxz.cc.h                       |  10 +
 src/include/operation/extensions/avx.cc.h     |  10 +
 src/include/operation/extensions/avx.h        |  10 +
 .../operation/extensions/extensions.cc.h      |  10 +
 src/include/operation/extensions/extensions.h |  10 +
 src/include/operation/extensions/reg.cc.h     |  10 +
 src/include/operation/extensions/reg.h        |  10 +
 src/include/operation/op_types.cc.h           |  11 +-
 src/include/operation/op_types.h              |   9 +
 src/include/operation/op_utility.cc.h         |  11 +-
 src/include/operation/op_utility.h            |  10 +
 src/include/operation/operation.cc.h          |  10 +
 src/include/operation/operation.h             |  10 +
 src/include/ranges/dindex.h                   |   2 +-
 src/include/ranges/index_format.h             |   3 +-
 src/include/ranges/index_pack.h               |   4 +-
 src/include/ranges/range_base.h               |   4 +-
 src/include/xpr/buf_xpr.cc.h                  |  10 +
 src/include/xpr/buf_xpr.h                     |  10 +
 src/include/xpr/for.cc.h                      |  10 +
 src/include/xpr/for.h                         |  10 +
 src/include/xpr/func.cc.h                     |  10 +
 src/include/xpr/func.h                        |  10 +
 src/include/xpr/index_id.cc.h                 |  10 +
 src/include/xpr/index_id.h                    |  10 +
 src/include/xpr/pos_type.cc.h                 |  10 +
 src/include/xpr/pos_type.h                    |  10 +
 src/include/xpr/vpos_type.cc.h                |  10 +
 src/include/xpr/vpos_type.h                   |  10 +
 src/include/xpr/xpr.cc.h                      |  10 +
 src/include/xpr/xpr.h                         |  10 +
 src/include/xpr/xpr_base.cc.h                 |  10 +
 src/include/xpr/xpr_base.h                    |  10 +
 src/lib/base/config.cc                        |  12 +
 src/lib/base/to_string.cc                     |  12 +
 src/lib/base/uuid.cc                          |  10 +
 src/lib/memory/memcount.cc                    |   5 +-
 src/lib/ranges/crange.cc                      |  10 +
 src/lib/ranges/dindex.cc                      |  10 +
 src/lib/ranges/index_format.cc                |  10 +
 src/lib/ranges/index_pack.cc                  |  10 +
 src/lib/ranges/range_base.cc                  |  10 +
 src/lib/ranges/yrange.cc                      |  10 +
 src/opt/cereal/tests/cereal_unit_test.cc      |  10 +
 src/opt/hdf5/include/h5_type_id.cc.h          |   2 +-
 src/opt/hdf5/include/h5_types.h               |   2 +-
 src/opt/hdf5/lib/h5_dataset.cc                |  10 +
 src/opt/hdf5/lib/h5_file.cc                   |  10 +
 src/opt/hdf5/lib/h5_group.cc                  |  10 +
 src/opt/hdf5/lib/h5_table.cc                  |  10 +
 src/opt/hdf5/tests/h5_basic_unit_test.cc      |  10 +
 src/tests/index_format_test.cc                |  11 +-
 src/tests/marray_unit_test.cc                 |   9 +
 src/tests/op_perf_test.cc                     | 304 ------------------
 src/tests/operation_unit_test.cc              |  10 +
 src/tests/range_unit_test.cc                  |  11 +-
 src/tests/test_numbers.cc                     |  12 +
 src/tests/test_numbers.h                      |  12 +-
 src/tests/xpr_unit_test.cc                    |  10 +
 65 files changed, 544 insertions(+), 334 deletions(-)
 delete mode 100644 src/tests/op_perf_test.cc

diff --git a/src/bin/config.cc b/src/bin/config.cc
index ad18459..7cf47bd 100644
--- a/src/bin/config.cc
+++ b/src/bin/config.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file bin/config.cc
+   @brief Program for printing cnorxz configurations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include <cstdlib>
 #include <iostream>
diff --git a/src/include/array/array.cc.h b/src/include/array/array.cc.h
index 1a90b0b..69566f7 100644
--- a/src/include/array/array.cc.h
+++ b/src/include/array/array.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/array/array.cc.h
-   @brief ...
+   @brief Array main header for template implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/array/array.h b/src/include/array/array.h
index d1a7358..4d7c23a 100644
--- a/src/include/array/array.h
+++ b/src/include/array/array.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/array/array.h
-   @brief ...
+   @brief Array main header.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/base/config.h b/src/include/base/config.h
index a4224e8..63a9871 100644
--- a/src/include/base/config.h
+++ b/src/include/base/config.h
@@ -2,11 +2,11 @@
 /**
    
    @file include/base/config.h
-   @brief runtime config functions
+   @brief Runtime config functions declarations.
 
-   Declare functions returning version and configuration infos
+   Declare functions returning version and configuration infos.
 
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/base/to_string.h b/src/include/base/to_string.h
index 1b00959..96c368a 100644
--- a/src/include/base/to_string.h
+++ b/src/include/base/to_string.h
@@ -2,9 +2,9 @@
 /**
    
    @file include/base/to_string.h
-   @brief String converter
+   @brief String converter declarations.
 
-   Declaration of functions that convert a given object/type to a string
+   Declaration of functions that convert a given object/type to a string.
    
    Copyright (c) 2022 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
diff --git a/src/include/base/uuid.h b/src/include/base/uuid.h
index df8da17..6bca169 100644
--- a/src/include/base/uuid.h
+++ b/src/include/base/uuid.h
@@ -2,7 +2,7 @@
 /**
    
    @file include/base/uuid.h
-   @brief uuid implementation
+   @brief cnorxz uuid declaration.
 
    Copyright (c) 2022 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
diff --git a/src/include/cnorxz.cc.h b/src/include/cnorxz.cc.h
index 46e5a5c..fdafce4 100644
--- a/src/include/cnorxz.cc.h
+++ b/src/include/cnorxz.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/cnorxz.cc.h
+   @brief cnorxz main template header
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "base/base.cc.h"
 #include "memory/memory.cc.h"
diff --git a/src/include/operation/extensions/avx.cc.h b/src/include/operation/extensions/avx.cc.h
index 4660b52..51328d5 100644
--- a/src/include/operation/extensions/avx.cc.h
+++ b/src/include/operation/extensions/avx.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/operation/extensions/avx.cc.h
+   @brief Register type implementaions for AVX.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_avx_cc_h__
 #define __cxz_avx_cc_h__
diff --git a/src/include/operation/extensions/avx.h b/src/include/operation/extensions/avx.h
index 20e3f52..af735f5 100644
--- a/src/include/operation/extensions/avx.h
+++ b/src/include/operation/extensions/avx.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/operation/extensions/avx.h
+   @brief Register type specialization for AVX.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_avx_h__
 #define __cxz_avx_h__
diff --git a/src/include/operation/extensions/extensions.cc.h b/src/include/operation/extensions/extensions.cc.h
index 1bdc7d9..9f64c25 100644
--- a/src/include/operation/extensions/extensions.cc.h
+++ b/src/include/operation/extensions/extensions.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/operation/extensions/extensions.cc.h
+   @brief Operation extensions template implementations main header.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_extensions_cc_h__
 #define __cxz_extensions_cc_h__
diff --git a/src/include/operation/extensions/extensions.h b/src/include/operation/extensions/extensions.h
index 8a52a6b..f750641 100644
--- a/src/include/operation/extensions/extensions.h
+++ b/src/include/operation/extensions/extensions.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/operation/extensions/extensions.h
+   @brief Operation extensions main header.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_extensions_h__
 #define __cxz_extensions_h__
diff --git a/src/include/operation/extensions/reg.cc.h b/src/include/operation/extensions/reg.cc.h
index 73560b9..39465d0 100644
--- a/src/include/operation/extensions/reg.cc.h
+++ b/src/include/operation/extensions/reg.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/operation/extensions/reg.cc.h
+   @brief Register type template implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_reg_cc_h__
 #define __cxz_reg_cc_h__
diff --git a/src/include/operation/extensions/reg.h b/src/include/operation/extensions/reg.h
index f03b848..89cf05a 100644
--- a/src/include/operation/extensions/reg.h
+++ b/src/include/operation/extensions/reg.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/operation/extensions/reg.h
+   @brief Register type declaration.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_reg_h__
 #define __cxz_reg_h__
diff --git a/src/include/operation/op_types.cc.h b/src/include/operation/op_types.cc.h
index 1dc514f..6ae55fd 100644
--- a/src/include/operation/op_types.cc.h
+++ b/src/include/operation/op_types.cc.h
@@ -1,9 +1,18 @@
+// -*- C++ -*-
+/**
+   
+   @file include/operation/op_types.cc.h
+   @brief Operation types template implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_op_types_cc_h__
 #define __cxz_op_types_cc_h__
 
 #include "op_types.h"
-//#include "xpr/xpr.h"
 #include "op_utility.h"
 #include "extensions/extensions.h"
 
diff --git a/src/include/operation/op_types.h b/src/include/operation/op_types.h
index ce0fa4a..addb020 100644
--- a/src/include/operation/op_types.h
+++ b/src/include/operation/op_types.h
@@ -1,4 +1,13 @@
 // -*- C++ -*-
+/**
+   
+   @file include/operation/op_types.h
+   @brief Operation types declarations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_op_types_h__
 #define __cxz_op_types_h__
diff --git a/src/include/operation/op_utility.cc.h b/src/include/operation/op_utility.cc.h
index ed8fa45..62f9b3d 100644
--- a/src/include/operation/op_utility.cc.h
+++ b/src/include/operation/op_utility.cc.h
@@ -1,10 +1,19 @@
+// -*- C++ -*-
+/**
+   
+   @file include/operation/op_utility.cc.h
+   @brief Operation utilities template implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_op_utility_cc_h__
 #define __cxz_op_utility_cc_h__
 
 #include "op_utility.h"
 #include "xpr/pos_type.h"
-//#include "operation/op_types.h"
 
 namespace CNORXZ
 {
diff --git a/src/include/operation/op_utility.h b/src/include/operation/op_utility.h
index dfabab4..94925c9 100644
--- a/src/include/operation/op_utility.h
+++ b/src/include/operation/op_utility.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/operation/op_utility.h
+   @brief Operation utilities declarations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_op_utility_h__
 #define __cxz_op_utility_h__
diff --git a/src/include/operation/operation.cc.h b/src/include/operation/operation.cc.h
index b1dd93c..0db4893 100644
--- a/src/include/operation/operation.cc.h
+++ b/src/include/operation/operation.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/operation/operation.cc.h
+   @brief Operation main header for template implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "op_types.cc.h"
 #include "op_utility.cc.h"
diff --git a/src/include/operation/operation.h b/src/include/operation/operation.h
index 1e560d9..3669206 100644
--- a/src/include/operation/operation.h
+++ b/src/include/operation/operation.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/operation/operation.h
+   @brief Operation main header.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "op_types.h"
 #include "op_utility.h"
diff --git a/src/include/ranges/dindex.h b/src/include/ranges/dindex.h
index 0408cc2..82cab3c 100644
--- a/src/include/ranges/dindex.h
+++ b/src/include/ranges/dindex.h
@@ -2,7 +2,7 @@
 /**
    
    @file include/ranges/dindex.h
-   @brief DIndex declaration
+   @brief DIndex declaration.
 
    Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
diff --git a/src/include/ranges/index_format.h b/src/include/ranges/index_format.h
index f67ae74..45e2b1d 100644
--- a/src/include/ranges/index_format.h
+++ b/src/include/ranges/index_format.h
@@ -2,8 +2,7 @@
 /**
    
    @file include/ranges/index_format.h
-   @brief ...
-
+   @brief Index formats declaration.
 
    Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
diff --git a/src/include/ranges/index_pack.h b/src/include/ranges/index_pack.h
index aab655d..ab7b02a 100644
--- a/src/include/ranges/index_pack.h
+++ b/src/include/ranges/index_pack.h
@@ -2,7 +2,7 @@
 /**
    
    @file include/ranges/index_pack.h
-   @brief Index pack declaration
+   @brief Index pack declarations.
 
    Index packs are sets of indices. In contrast to multi-indices like
    (G)MIndex or YIndex, there is no format that can be used to determine
@@ -10,7 +10,7 @@
    Nevertheless, a function pos() is implemented, which just returns
    the same value as lex().
 
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
 
 **/
diff --git a/src/include/ranges/range_base.h b/src/include/ranges/range_base.h
index 0ca0037..308f07d 100644
--- a/src/include/ranges/range_base.h
+++ b/src/include/ranges/range_base.h
@@ -2,12 +2,12 @@
 /**
    
    @file include/ranges/range_base.h
-   @brief RangeBase declaration
+   @brief RangeBase declaration.
 
    Include basic headers containing defintions and macros
    used throughout this library
 
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/xpr/buf_xpr.cc.h b/src/include/xpr/buf_xpr.cc.h
index cac20ec..ff2d667 100644
--- a/src/include/xpr/buf_xpr.cc.h
+++ b/src/include/xpr/buf_xpr.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/buf_xpr.cc.h
+   @brief Buffer xpression template implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "buf_xpr.h"
 
diff --git a/src/include/xpr/buf_xpr.h b/src/include/xpr/buf_xpr.h
index cd0b51f..d960c69 100644
--- a/src/include/xpr/buf_xpr.h
+++ b/src/include/xpr/buf_xpr.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/buf_xpr.h
+   @brief Buffer xpression declarations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "xpr_base.h"
 
diff --git a/src/include/xpr/for.cc.h b/src/include/xpr/for.cc.h
index 493c035..ba6a07e 100644
--- a/src/include/xpr/for.cc.h
+++ b/src/include/xpr/for.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/for.cc.h
+   @brief For expressions template implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_for_cc_h__
 #define __cxz_for_cc_h__
diff --git a/src/include/xpr/for.h b/src/include/xpr/for.h
index ea56ade..a12e7bb 100644
--- a/src/include/xpr/for.h
+++ b/src/include/xpr/for.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/for.h
+   @brief For expressions declarations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_for_h__
 #define __cxz_for_h__
diff --git a/src/include/xpr/func.cc.h b/src/include/xpr/func.cc.h
index e290251..f1b6b89 100644
--- a/src/include/xpr/func.cc.h
+++ b/src/include/xpr/func.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/func.cc.h
+   @brief Special function objects implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_func_cc_h__
 #define __cxz_func_cc_h__
diff --git a/src/include/xpr/func.h b/src/include/xpr/func.h
index 5160674..206e843 100644
--- a/src/include/xpr/func.h
+++ b/src/include/xpr/func.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/func.h
+   @brief Special function objects declarations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_func_h__
 #define __cxz_func_h__
diff --git a/src/include/xpr/index_id.cc.h b/src/include/xpr/index_id.cc.h
index 09eaddb..b730036 100644
--- a/src/include/xpr/index_id.cc.h
+++ b/src/include/xpr/index_id.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/index_id.cc.h
+   @brief Index ID type template implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_index_id_cc_h__
 #define __cxz_index_id_cc_h__
diff --git a/src/include/xpr/index_id.h b/src/include/xpr/index_id.h
index ed61d68..3cc7ae0 100644
--- a/src/include/xpr/index_id.h
+++ b/src/include/xpr/index_id.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/index_id.h
+   @brief Index ID type declarations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_index_id_h__
 #define __cxz_index_id_h__
diff --git a/src/include/xpr/pos_type.cc.h b/src/include/xpr/pos_type.cc.h
index 77f6b92..f4ade10 100644
--- a/src/include/xpr/pos_type.cc.h
+++ b/src/include/xpr/pos_type.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/pos_type.cc.h
+   @brief Position types template implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_pos_type_cc_h__
 #define __cxz_pos_type_cc_h__
diff --git a/src/include/xpr/pos_type.h b/src/include/xpr/pos_type.h
index 5515407..1817726 100644
--- a/src/include/xpr/pos_type.h
+++ b/src/include/xpr/pos_type.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/pos_type.h
+   @brief Position types declarations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_pos_type_h__
 #define __cxz_pos_type_h__
diff --git a/src/include/xpr/vpos_type.cc.h b/src/include/xpr/vpos_type.cc.h
index 19ebb9a..4df2dc1 100644
--- a/src/include/xpr/vpos_type.cc.h
+++ b/src/include/xpr/vpos_type.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/vpos_type.cc.h
+   @brief Dynamic position types template implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_vpos_type_cc_h__
 #define __cxz_vpos_type_cc_h__
diff --git a/src/include/xpr/vpos_type.h b/src/include/xpr/vpos_type.h
index 064cb85..985c018 100644
--- a/src/include/xpr/vpos_type.h
+++ b/src/include/xpr/vpos_type.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/vpos_type.h
+   @brief Dynamic position types declarations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_vpos_type_h__
 #define __cxz_vpos_type_h__
diff --git a/src/include/xpr/xpr.cc.h b/src/include/xpr/xpr.cc.h
index dd8a5d6..87f3dc4 100644
--- a/src/include/xpr/xpr.cc.h
+++ b/src/include/xpr/xpr.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/xpr.cc.h
+   @brief Xpression template implementations main header.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "vpos_type.cc.h"
 #include "pos_type.cc.h"
diff --git a/src/include/xpr/xpr.h b/src/include/xpr/xpr.h
index 063a8bd..c98a825 100644
--- a/src/include/xpr/xpr.h
+++ b/src/include/xpr/xpr.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/xpr.h
+   @brief Xpression main header.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "vpos_type.h"
 #include "pos_type.h"
diff --git a/src/include/xpr/xpr_base.cc.h b/src/include/xpr/xpr_base.cc.h
index dcc24c5..43fdf6c 100644
--- a/src/include/xpr/xpr_base.cc.h
+++ b/src/include/xpr/xpr_base.cc.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/xpr_base.cc.h
+   @brief Xpression base template implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_xpr_base_cc_h__
 #define __cxz_xpr_base_cc_h__
diff --git a/src/include/xpr/xpr_base.h b/src/include/xpr/xpr_base.h
index 05e7f8b..a25cdee 100644
--- a/src/include/xpr/xpr_base.h
+++ b/src/include/xpr/xpr_base.h
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file include/xpr/xpr_base.h
+   @brief Xpression base declarations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __cxz_xpr_base_h__
 #define __cxz_xpr_base_h__
diff --git a/src/lib/base/config.cc b/src/lib/base/config.cc
index f13756a..a502939 100644
--- a/src/lib/base/config.cc
+++ b/src/lib/base/config.cc
@@ -1,3 +1,15 @@
+// -*- C++ -*-
+/**
+   
+   @file lib/base/config.cc
+   @brief Runtime config functions implementations.
+
+   Declare functions returning version and configuration infos.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "base/config.h"
 
diff --git a/src/lib/base/to_string.cc b/src/lib/base/to_string.cc
index 8289ffc..53fe25e 100644
--- a/src/lib/base/to_string.cc
+++ b/src/lib/base/to_string.cc
@@ -1,3 +1,15 @@
+// -*- C++ -*-
+/**
+   
+   @file lib/base/to_string.cc
+   @brief String converter implementations.
+
+   Declaration of functions that convert a given object/type to a string.
+   
+   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "base/base.h"
 
diff --git a/src/lib/base/uuid.cc b/src/lib/base/uuid.cc
index 7ecbced..c2b4e2c 100644
--- a/src/lib/base/uuid.cc
+++ b/src/lib/base/uuid.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file lib/base/uuid.cc
+   @brief cnorxz uuid implementation.
+
+   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include <random>
 #include <ctime>
diff --git a/src/lib/memory/memcount.cc b/src/lib/memory/memcount.cc
index 7ca0ebb..2332efe 100644
--- a/src/lib/memory/memcount.cc
+++ b/src/lib/memory/memcount.cc
@@ -2,10 +2,9 @@
 /**
    
    @file lib/memory/memcount.cc
-   @brief ...
+   @brief Implementation of MemCount member functions.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/lib/ranges/crange.cc b/src/lib/ranges/crange.cc
index cf6ec9e..9b797d3 100644
--- a/src/lib/ranges/crange.cc
+++ b/src/lib/ranges/crange.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file lib/ranges/crange.cc
+   @brief CRange and CIndex member function implementation.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "ranges/ranges.h"
 #include "ranges/prange.h"
diff --git a/src/lib/ranges/dindex.cc b/src/lib/ranges/dindex.cc
index c1dc73a..1e85da4 100644
--- a/src/lib/ranges/dindex.cc
+++ b/src/lib/ranges/dindex.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file lib/ranges/dindex.cc
+   @brief DIndex implementation.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "ranges/ranges.h"
 
diff --git a/src/lib/ranges/index_format.cc b/src/lib/ranges/index_format.cc
index 36580da..746ed8c 100644
--- a/src/lib/ranges/index_format.cc
+++ b/src/lib/ranges/index_format.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file lib/ranges/index_format.cc
+   @brief Index formats implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "ranges/index_format.h"
 
diff --git a/src/lib/ranges/index_pack.cc b/src/lib/ranges/index_pack.cc
index 5ed6bc2..5e66ee1 100644
--- a/src/lib/ranges/index_pack.cc
+++ b/src/lib/ranges/index_pack.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file lib/ranges/index_pack.cc
+   @brief Index pack implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+**/
 
 #include "ranges/ranges.h"
 
diff --git a/src/lib/ranges/range_base.cc b/src/lib/ranges/range_base.cc
index a90369b..749c5f7 100644
--- a/src/lib/ranges/range_base.cc
+++ b/src/lib/ranges/range_base.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file lib/ranges/range_base.cc
+   @brief RangeBase implementation.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "ranges/ranges.h"
 #include "array/array.h"
diff --git a/src/lib/ranges/yrange.cc b/src/lib/ranges/yrange.cc
index b456995..0f799b9 100644
--- a/src/lib/ranges/yrange.cc
+++ b/src/lib/ranges/yrange.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file lib/ranges/yrange.cc
+   @brief YRange and YIndex implementations.
+
+   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "ranges/ranges.h"
 #include "array/array.h"
diff --git a/src/opt/cereal/tests/cereal_unit_test.cc b/src/opt/cereal/tests/cereal_unit_test.cc
index 1fc1039..ac0a551 100644
--- a/src/opt/cereal/tests/cereal_unit_test.cc
+++ b/src/opt/cereal/tests/cereal_unit_test.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file opt/cereal/tests/cereal_unit_test.cc
+   @brief cnorxz cereal unit tests.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include <cstdlib>
 #include <iostream>
diff --git a/src/opt/hdf5/include/h5_type_id.cc.h b/src/opt/hdf5/include/h5_type_id.cc.h
index b7624bd..e890eb2 100644
--- a/src/opt/hdf5/include/h5_type_id.cc.h
+++ b/src/opt/hdf5/include/h5_type_id.cc.h
@@ -1,7 +1,7 @@
 // -*- C++ -*-
 /**
 
-   @file opt/hdf5/include/h5_type_id.h
+   @file opt/hdf5/include/h5_type_id.cc.h
    @brief TypeId template implementation.
 
    Copyright (c) 2024 Christian Zimmermann. All rights reserved.
diff --git a/src/opt/hdf5/include/h5_types.h b/src/opt/hdf5/include/h5_types.h
index 46beb8d..2437e9f 100644
--- a/src/opt/hdf5/include/h5_types.h
+++ b/src/opt/hdf5/include/h5_types.h
@@ -1,7 +1,7 @@
 // -*- C++ -*-
 /**
    
-   @file opt/hdf5/include/types.h
+   @file opt/hdf5/include/h5_types.h
    @brief Declaration of hdf5 related library types
 
    This file contains the declaration of all hdf5 related library types
diff --git a/src/opt/hdf5/lib/h5_dataset.cc b/src/opt/hdf5/lib/h5_dataset.cc
index 1fbfe72..a3ef41d 100644
--- a/src/opt/hdf5/lib/h5_dataset.cc
+++ b/src/opt/hdf5/lib/h5_dataset.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/hdf5/lib/h5_dataset.cc
+   @brief Dataset implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #include "h5_dataset.h"
 
diff --git a/src/opt/hdf5/lib/h5_file.cc b/src/opt/hdf5/lib/h5_file.cc
index fe42fa5..0730786 100644
--- a/src/opt/hdf5/lib/h5_file.cc
+++ b/src/opt/hdf5/lib/h5_file.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/hdf5/lib/h5_file.cc
+   @brief Group implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #include "h5_file.h"
 #include <fstream>
diff --git a/src/opt/hdf5/lib/h5_group.cc b/src/opt/hdf5/lib/h5_group.cc
index a5d093f..37f8bc3 100644
--- a/src/opt/hdf5/lib/h5_group.cc
+++ b/src/opt/hdf5/lib/h5_group.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/hdf5/lib/h5_group.cc
+   @brief Group implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #include "h5_group.h"
 #include "h5_table.h"
diff --git a/src/opt/hdf5/lib/h5_table.cc b/src/opt/hdf5/lib/h5_table.cc
index 268e8b3..1ac7fa5 100644
--- a/src/opt/hdf5/lib/h5_table.cc
+++ b/src/opt/hdf5/lib/h5_table.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+
+   @file opt/hdf5/lib/h5_table.cc
+   @brief Table implementations.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+
+ **/
 
 #include <hdf5_hl.h>
 #include "h5_table.h"
diff --git a/src/opt/hdf5/tests/h5_basic_unit_test.cc b/src/opt/hdf5/tests/h5_basic_unit_test.cc
index 41399b7..e589556 100644
--- a/src/opt/hdf5/tests/h5_basic_unit_test.cc
+++ b/src/opt/hdf5/tests/h5_basic_unit_test.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file opt/hdf5/tests/h5_basic_unit_test.cc
+   @brief cnorxz hdf5 basic unit tests.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include <cstdlib>
 #include <iostream>
diff --git a/src/tests/index_format_test.cc b/src/tests/index_format_test.cc
index e747d5f..4e33128 100644
--- a/src/tests/index_format_test.cc
+++ b/src/tests/index_format_test.cc
@@ -1,10 +1,19 @@
+// -*- C++ -*-
+/**
+   
+   @file tests/index_format_test.cc
+   @brief Index format unit tests.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include <cstdlib>
 #include <iostream>
 
 #include "gtest/gtest.h"
 
-//#include "cnorxz.h"
 #include "ranges/ranges.h"
 #include "array/array.h"
 
diff --git a/src/tests/marray_unit_test.cc b/src/tests/marray_unit_test.cc
index a565438..7550f25 100644
--- a/src/tests/marray_unit_test.cc
+++ b/src/tests/marray_unit_test.cc
@@ -1,4 +1,13 @@
 // -*- C++ -*-
+/**
+   
+   @file tests/marray_unit_test.cc
+   @brief MArray unit tests.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include <cstdlib>
 #include <iostream>
diff --git a/src/tests/op_perf_test.cc b/src/tests/op_perf_test.cc
deleted file mode 100644
index 6c8bf50..0000000
--- a/src/tests/op_perf_test.cc
+++ /dev/null
@@ -1,304 +0,0 @@
-// -*- C++ -*-
-
-#include <cstdlib>
-#include <iostream>
-#include <cassert>
-
-#include "cnorxz.h"
-#include "conversions.h"
-
-#include <ctime>
-#include <cmath>
-#include <chrono>
-
-#define ONLY_SPIN
-
-namespace MAT = CNORXZ;
-
-namespace {
-
-    double xround(double arg)
-    {
-	return roundf(arg * 100000.) / 100000.;
-    }
-    
-    using namespace MAT;
-
-    template <class Factory>
-    void swapFactory(std::shared_ptr<RangeFactoryBase>& fptr)
-    {
-	auto nptr = std::make_shared<Factory>();
-	fptr = nptr;
-    }
-    
-    template <class Factory, typename T>
-    void swapFactory(std::shared_ptr<RangeFactoryBase>& fptr, std::initializer_list<T> ilist)
-    {
-	vector<T> tmp = ilist;
-	auto nptr = std::make_shared<Factory>( tmp );
-	fptr = nptr;
-    }
-
-    template <class Factory, typename T>
-    void swapFactory(std::shared_ptr<RangeFactoryBase>& fptr, vector<T>& ilist)
-    {
-	vector<T> tmp = ilist;
-	auto nptr = std::make_shared<Factory>( tmp );
-	fptr = nptr;
-    }
-
-    
-    template <class Factory, class... Rs>
-    void swapMFactory(std::shared_ptr<RangeFactoryBase>& fptr, const Rs&... rs)
-    {
-	auto nptr = std::make_shared<Factory>( rs... );
-	fptr = nptr;
-    }
-
-    template <typename... Ts>
-    auto mkt(Ts&&... ts) -> decltype(std::make_tuple(ts...))
-    {
-	return std::make_tuple(ts...);
-    }
-
-    template <typename... Ts>
-    auto mkts(Ts&&... ts) -> decltype(std::make_tuple(ts...))
-    {
-	return std::make_tuple(static_cast<size_t>( ts )...);
-    }
-#ifndef ONLY_SPIN    
-    class OpTest_Performance
-    {
-    public:
-
-	typedef SingleRangeFactory<size_t,SpaceType::ANY> SRF;
-	typedef SRF::oType SRange;
-
-	typedef MultiRangeFactory<SRange,SRange> MRF;
-	typedef MRF::oType MRange;
-
-	OpTest_Performance()
-	{
-	
-	    vector<size_t> initvec1(vs1);
- 	    cv1.resize(vs1);
-	    for(size_t i = 0; i != vs1; ++i){
-		initvec1[i] = i;
-		cv1[i] = sqrt( static_cast<double>(i)*0.53 );
-	    }
-
-	    vector<size_t> initvec2(vs2);
-	    cv2.resize(vs2*vs1);
-	    for(size_t i = 0; i != vs2; ++i){
-		initvec2[i] = i;
-		for(size_t j = 0; j != vs1; ++j){
-		    cv2[i*vs1 + j] = static_cast<double>(i) * sin(static_cast<double>(j)*0.4);
-		}
-	    }
-
-	    swapFactory<SRF>(rfbptr, initvec1);
-	    sr1ptr = std::dynamic_pointer_cast<SRange>(rfbptr->create());
-
-	    swapFactory<SRF>(rfbptr, initvec2);
-	    sr2ptr = std::dynamic_pointer_cast<SRange>(rfbptr->create());
-
-	    swapMFactory<MRF>(rfbptr, sr2ptr, sr1ptr);
-	    mrptr = std::dynamic_pointer_cast<MRange>(rfbptr->create());
-	}
-
-	void PCheck();
-
-	
-    private:
-	//const size_t vs1 = 10000;
-	//const size_t vs2 = 1000;
-	const size_t vs1 = 4000;
-	const size_t vs2 = 2500;
- 
-	std::shared_ptr<RangeFactoryBase> rfbptr;
-	std::shared_ptr<SRange> sr1ptr;
-	std::shared_ptr<SRange> sr2ptr;
-	std::shared_ptr<MRange> mrptr;
-
-	vector<double> cv1;
-	vector<double> cv2;
-    };
-#endif
-    class OpTest_Spin
-    {
-    public:
-
-        typedef ClassicRF CRF;
-        typedef ClassicRange CR;
-        
-	typedef SpinRF SRF;
-	typedef SpinRange SR;
-	typedef MultiRangeFactory<SR,SR,SR,SR,SR,SR,SR,SR> SR8F;
- 	typedef SR8F::oType SR8;
- 
-          static const size_t os = 3000;
-          static const size_t is = 65536;
-          static const size_t s = is*os;
-	
-	OpTest_Spin()
-	{
-	    data.resize(is);
-	    for(size_t i = 0; i != is; ++i){
-		double arg = static_cast<double>( i - s ) - 0.1; 
-		data[i] = sin(arg);
-		//VCHECK(data[i]);
-	    }
-	    SRF f;
-	    sr = std::dynamic_pointer_cast<SR>(f.create());
-            CRF cf(os);
-            cr = std::dynamic_pointer_cast<CR>(cf.create());
-	}
-
-     	void contract();
-	
-    private:
-	
-	vector<double> data;
-	std::shared_ptr<SR> sr;
-        std::shared_ptr<CR> cr;
-    };
-
-    void OpTest_Spin::contract()
-    {
-	Array<double,SR,SR,SR,SR,SR,SR,SR,SR> ma( sr, sr, sr, sr, sr, sr, sr, sr, data);
-	Array<double,CR,SR,SR> res1( cr, sr, sr );
-
-        auto ii = MAT::getIndex<CR>(cr);
-        auto jj = MAT::getIndex<CR>(cr);
-	auto alpha = MAT::getIndex<SR>();
-	auto beta = MAT::getIndex<SR>();
-	auto gamma = MAT::getIndex<SR>();
-	auto delta = MAT::getIndex<SR>();
-	auto deltap = MAT::getIndex<SR>();
-	//auto deltap = MAT::getIndex<GenSingleRange<size_t,SpaceType::NONE,1>>();
-	
-	auto mix = MAT::mkMIndex( jj, alpha, beta, gamma );
-
-        
-	vector<double> vres(4*4*os);
-	for(size_t d = 0; d != 4; ++d){
-	    for(size_t p = 0; p != 4; ++p){
-		const size_t tidx = d*4 + p;
-		vres[tidx] = 0.;
-	    }
-	}                  
-        auto begin2 = std::chrono::system_clock::now();
-	double* vrptr = vres.data();
-	double* dptr = data.data();
-        for(size_t i = 0; i != os; ++i){
-            for(size_t d = 0; d != 4; ++d){
-                for(size_t j = 0; j != os; ++j) {
-                    for(size_t a = 0; a != 4; ++a){
-                        for(size_t b = 0; b != 4; ++b){
-                            for(size_t c = 0; c != 4; ++c){
-				const size_t tidx = i*4*4 + d*4;
-				const size_t sidx = /*i*65536 +*/ d*4*4*4*4*4*4*4 + a*5*4*4*4*4*4 + b*5*4*4*4 + c*5*4;
-				double* xvrptr = vrptr + tidx;
-				double* xdptr = dptr + sidx;
-#pragma omp simd aligned(xvrptr, xdptr: 32)
-                                for(int p = 0; p < 4; p++){
-                                    xvrptr[p] += xdptr[p];
-                                }
-                            }
-                        }
-                    }
-                }
-            }
-	}
-        auto end2 = std::chrono::system_clock::now();
-	std::cout << "vector - for loop time: " << std::chrono::duration<double>(end2-begin2).count()
-		  << std::endl;
-
-        
-        auto begin = std::chrono::system_clock::now();
-	//for(size_t i = 0; i != os; ++i){
-        res1(ii ,delta, deltap).par() += ma(delta, alpha, alpha, beta, beta, gamma, gamma, deltap).c(mix);
-        //tcast<v256>(res1)(ii ,delta, deltap).par() += tcast<v256>(ma)(delta, alpha, alpha, beta, beta, gamma, gamma, deltap).c(mix);
-	//}
-        auto end = std::chrono::system_clock::now();
-	std::cout << "Array time: " << std::chrono::duration<double>(end-begin).count()
-		  << std::endl;
-	
-	assert( xround(res1.at(mkts(0,0,0))) == xround(vres[0]) );
-	assert( xround(res1.at(mkts(0,0,1))) == xround(vres[1]) );
-	assert( xround(res1.at(mkts(0,0,2))) == xround(vres[2]) );
-	assert( xround(res1.at(mkts(0,0,3))) == xround(vres[3]) );
-	
-	assert( xround(res1.at(mkts(0,1,0))) == xround(vres[4]) );
-	assert( xround(res1.at(mkts(0,1,1))) == xround(vres[5]) );
-	assert( xround(res1.at(mkts(0,1,2))) == xround(vres[6]) );
-	assert( xround(res1.at(mkts(0,1,3))) == xround(vres[7]) );
-
-	assert( xround(res1.at(mkts(0,2,0))) == xround(vres[8]) );
-	assert( xround(res1.at(mkts(0,2,1))) == xround(vres[9]) );
-	assert( xround(res1.at(mkts(0,2,2))) == xround(vres[10]) );
-	assert( xround(res1.at(mkts(0,2,3))) == xround(vres[11]) );
-
-	assert( xround(res1.at(mkts(0,3,0))) == xround(vres[12]) );
-	assert( xround(res1.at(mkts(0,3,1))) == xround(vres[13]) );
-	assert( xround(res1.at(mkts(0,3,2))) == xround(vres[14]) );
-	assert( xround(res1.at(mkts(0,3,3))) == xround(vres[15]) );
-
-	std::cout << "ratio: "
-                  << std::chrono::duration<double>(end-begin).count() / std::chrono::duration<double>(end2-begin2).count()
-                  << std::endl;
-    }    
-#ifndef ONLY_SPIN    
-    void OpTest_Performance::PCheck()
-    {
-	Array<double,MRange> ma2(mrptr, cv2);
-	Array<double,SRange> ma1(sr1ptr, cv1);
-	Array<double,MRange> res(mrptr);
-
-	auto si1 = MAT::getIndex(sr1ptr);
-	auto si2 = MAT::getIndex(sr2ptr);
-	auto mi = MAT::getIndex(mrptr);
-	(*mi)(si2, si1);
-
-	std::clock_t begin = std::clock();
-	
-	res(mi) = ma2(mi) * ma1(si1);
-
-	std::clock_t end = std::clock();
-	std::cout << "Array time: " << static_cast<double>( end - begin ) / CLOCKS_PER_SEC
-		  << std::endl;
-
-	vector<double> res2(vs1*vs2);
-	std::clock_t begin2 = std::clock();
-	
-	for(size_t i = 0; i != vs2; ++i){
-	    for(size_t j = 0; j != vs1; ++j){
-		res2[i*vs1 + j] = cv1[j] * cv2[i*vs1 + j];
-	    }
-	}
-
-	std::clock_t end2 = std::clock();
-	std::cout << "vector - for loop time: " << static_cast<double>( end2 - begin2 ) / CLOCKS_PER_SEC
-		  << std::endl;
-
-	std::cout << "ratio: " << static_cast<double>( end - begin ) / static_cast<double>( end2 - begin2 ) << std::endl;
-
-	assert( xround( res.at(mkt(7,9)) ) == xround(res2[7*vs1 + 9]) );
-	//assert( xround( res.at(mkt(700,900)) ) == xround(res2[700*vs1 + 900]) );
-	
-    }
-#endif    
-} // anonymous namspace
-
-int main(int argc, char** argv)
-{
-#ifndef ONLY_SPIN
-    OpTest_Performance pt;
-    pt.PCheck();
-#endif
-    OpTest_Spin st;
-    st.contract();
-
-    
-    return 0;
-}
diff --git a/src/tests/operation_unit_test.cc b/src/tests/operation_unit_test.cc
index 8a4e532..5812f02 100644
--- a/src/tests/operation_unit_test.cc
+++ b/src/tests/operation_unit_test.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file tests/operation_unit_test.cc
+   @brief Operation unit tests.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include <cstdlib>
 #include <iostream>
diff --git a/src/tests/range_unit_test.cc b/src/tests/range_unit_test.cc
index 4ac711e..4a56139 100644
--- a/src/tests/range_unit_test.cc
+++ b/src/tests/range_unit_test.cc
@@ -1,10 +1,19 @@
+// -*- C++ -*-
+/**
+   
+   @file tests/range_unit_test.cc
+   @brief Range unit tests.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include <cstdlib>
 #include <iostream>
 
 #include "gtest/gtest.h"
 
-//#include "cnorxz.h"
 #include "ranges/ranges.h"
 #include "array/array.h"
 
diff --git a/src/tests/test_numbers.cc b/src/tests/test_numbers.cc
index 81b1240..cdef0f4 100644
--- a/src/tests/test_numbers.cc
+++ b/src/tests/test_numbers.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file tests/test_numbers.cc
+   @brief Test numbers instanciation.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "test_numbers.h"
 
@@ -5,6 +15,8 @@ namespace CNORXZ
 {
     namespace Test
     {
+	/** @cond 0 */
 	Vector<Double> Numbers::sCont;
+	/** @endcond */
     }
 }
diff --git a/src/tests/test_numbers.h b/src/tests/test_numbers.h
index 0d4e52a..05d9cc7 100644
--- a/src/tests/test_numbers.h
+++ b/src/tests/test_numbers.h
@@ -1,10 +1,18 @@
+// -*- C++ -*-
+/**
+   
+   @file tests/test_numbers.h
+   @brief Test numbers utilities.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #ifndef __test_numbers_h__
 #define __test_numbers_h__
 
 #include <fstream>
-//#include "base/types.h"
-//#include "base/assert.h"
 #include "base/base.h"
 
 namespace CNORXZ
diff --git a/src/tests/xpr_unit_test.cc b/src/tests/xpr_unit_test.cc
index 8e72fec..567ff8d 100644
--- a/src/tests/xpr_unit_test.cc
+++ b/src/tests/xpr_unit_test.cc
@@ -1,3 +1,13 @@
+// -*- C++ -*-
+/**
+   
+   @file tests/xpr_unit_test.cc
+   @brief Xpression unit tests.
+
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
+   Mail: chizeta@f3l.de
+   
+**/
 
 #include "gtest/gtest.h"
 
-- 
2.45.2


From 8a0fdf7a7cdc73ab5b2721121522cabcef42ee8f Mon Sep 17 00:00:00 2001
From: Christian Zimmermann <christian.zimmermann@ur.de>
Date: Sat, 3 Feb 2024 23:21:40 +0100
Subject: [PATCH 5/9] improve comment notation + add missing briefs

---
 src/include/array/aindex.cc.h               |  5 +-
 src/include/array/aindex.h                  |  5 +-
 src/include/array/array_base.cc.h           |  5 +-
 src/include/array/array_base.h              |  5 +-
 src/include/array/marray.cc.h               |  5 +-
 src/include/array/marray.h                  |  5 +-
 src/include/array/slice.cc.h                |  5 +-
 src/include/array/slice.h                   |  5 +-
 src/include/base/types.h                    |  4 +-
 src/include/memory/memcount.h               |  5 +-
 src/include/memory/memory.cc.h              |  5 +-
 src/include/memory/memory.h                 |  5 +-
 src/include/operation/basic_operations.cc.h | 18 +++----
 src/include/operation/extensions/avx.cc.h   | 24 ++++-----
 src/include/operation/extensions/reg.cc.h   | 24 ++++-----
 src/include/operation/extensions/reg.h      | 36 +++++++-------
 src/include/ranges/crange.cc.h              |  5 +-
 src/include/ranges/dindex.cc.h              |  3 +-
 src/include/ranges/dindex.h                 |  2 +-
 src/include/ranges/eindex.cc.h              |  5 +-
 src/include/ranges/eindex.h                 |  3 +-
 src/include/ranges/index_base.cc.h          | 17 +++----
 src/include/ranges/index_base.h             |  5 +-
 src/include/ranges/index_format.cc.h        | 23 +++++----
 src/include/ranges/index_mul.cc.h           | 21 ++++----
 src/include/ranges/index_pack.cc.h          | 29 ++++++-----
 src/include/ranges/lindex.cc.h              |  3 +-
 src/include/ranges/range_base.cc.h          |  5 +-
 src/include/ranges/ranges.cc.h              |  5 +-
 src/include/ranges/srange.cc.h              | 29 ++++++-----
 src/include/ranges/urange.cc.h              | 29 ++++++-----
 src/include/ranges/xindex.cc.h              | 11 ++---
 src/include/xpr/for.cc.h                    | 48 +++++++++---------
 src/include/xpr/pos_type.cc.h               | 54 ++++++++++-----------
 src/include/xpr/pos_type.h                  | 12 ++---
 src/include/xpr/vpos_type.cc.h              | 30 ++++++------
 src/include/xpr/xpr_base.cc.h               | 12 ++---
 src/lib/ranges/range_base.cc                | 18 +++----
 src/lib/ranges/yrange.cc                    | 42 ++++++++--------
 src/opt/cereal/include/cer_ranges.cc.h      | 12 ++---
 40 files changed, 279 insertions(+), 305 deletions(-)

diff --git a/src/include/array/aindex.cc.h b/src/include/array/aindex.cc.h
index ac45c4a..e28c257 100644
--- a/src/include/array/aindex.cc.h
+++ b/src/include/array/aindex.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/array/aindex.cc.h
-   @brief ...
+   @brief Array index template implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/array/aindex.h b/src/include/array/aindex.h
index 0352376..7f7a411 100644
--- a/src/include/array/aindex.h
+++ b/src/include/array/aindex.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/array/aindex.h
-   @brief ...
+   @brief Array index declaration.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/array/array_base.cc.h b/src/include/array/array_base.cc.h
index ae1218f..cd71cdf 100644
--- a/src/include/array/array_base.cc.h
+++ b/src/include/array/array_base.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/array/array_base.cc.h
-   @brief ...
+   @brief Array base class template implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/array/array_base.h b/src/include/array/array_base.h
index f74f83b..9e3ad07 100644
--- a/src/include/array/array_base.h
+++ b/src/include/array/array_base.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/array/array_base.h
-   @brief ...
+   @brief Array base class declarations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/array/marray.cc.h b/src/include/array/marray.cc.h
index 3ea3923..d60b07d 100644
--- a/src/include/array/marray.cc.h
+++ b/src/include/array/marray.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/array/marray.cc.h
-   @brief ...
+   @brief MArray implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/array/marray.h b/src/include/array/marray.h
index 9445ec7..384cacb 100644
--- a/src/include/array/marray.h
+++ b/src/include/array/marray.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/array/marray.h
-   @brief ...
+   @brief MArray declarations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/array/slice.cc.h b/src/include/array/slice.cc.h
index 1dca0cf..95131b9 100644
--- a/src/include/array/slice.cc.h
+++ b/src/include/array/slice.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/array/slice.cc.h
-   @brief ...
+   @brief Slice implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/array/slice.h b/src/include/array/slice.h
index a636b1a..fab06da 100644
--- a/src/include/array/slice.h
+++ b/src/include/array/slice.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/array/slice.h
-   @brief ...
+   @brief Slice declarations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/base/types.h b/src/include/base/types.h
index 77dbc98..9ba70d3 100644
--- a/src/include/base/types.h
+++ b/src/include/base/types.h
@@ -84,7 +84,7 @@ namespace CNORXZ
      |   library types   |
      +===================*/
 
-    /***
+    /*
 	Naming Prefixes:
 	D = Y = Dynamic
 	V = X = Virtual
@@ -100,7 +100,7 @@ namespace CNORXZ
 	A = (const) Array
 	B = (mutable) Array
 	F = Functional, Map,...
-     ***/
+     */
 
     // default template parameter
     class None {};
diff --git a/src/include/memory/memcount.h b/src/include/memory/memcount.h
index f69c261..6dc9268 100644
--- a/src/include/memory/memcount.h
+++ b/src/include/memory/memcount.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/memory/memcount.h
-   @brief ...
+   @brief MemCount declaration.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/memory/memory.cc.h b/src/include/memory/memory.cc.h
index 19a1181..82ffc2f 100644
--- a/src/include/memory/memory.cc.h
+++ b/src/include/memory/memory.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/memory/memory.cc.h
-   @brief ...
+   @brief Memory template implementations main header.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/memory/memory.h b/src/include/memory/memory.h
index 6f1ec8c..85be208 100644
--- a/src/include/memory/memory.h
+++ b/src/include/memory/memory.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/memory/memory.h
-   @brief ...
+   @brief Memory main heade.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/operation/basic_operations.cc.h b/src/include/operation/basic_operations.cc.h
index df23e01..49d937c 100644
--- a/src/include/operation/basic_operations.cc.h
+++ b/src/include/operation/basic_operations.cc.h
@@ -16,9 +16,9 @@
 
 namespace CNORXZ
 {
-    /************************************
-     *   standard operatrions (unary)   *
-     ************************************/
+    /*==================================+
+     |   standard operatrions (unary)   |
+     +==================================*/
 
     template <class Op>
     constexpr decltype(auto) minus(const COpInterface<Op>& op)
@@ -26,9 +26,9 @@ namespace CNORXZ
 	return operation( [](const auto& a) { return -a; }, op.THIS() );
     }
 
-    /*************************************
-     *   standard operatrions (binary)   *
-     *************************************/
+    /*===================================+
+     |   standard operatrions (binary)   |
+     +===================================*/
 
     template <class Op1, class Op2>
     constexpr decltype(auto) plus(const COpInterface<Op1>& op1, const COpInterface<Op2>& op2)
@@ -65,9 +65,9 @@ namespace CNORXZ
 			  op1.THIS(), op2.THIS() );
     }
 
-    /*****************************************
-     *   operators for standard operations   *
-     *****************************************/
+    /*=======================================+
+     |   operators for standard operations   |
+     +=======================================*/
 
     template <class Op>
     constexpr decltype(auto) operator-(const COpInterface<Op>& op)
diff --git a/src/include/operation/extensions/avx.cc.h b/src/include/operation/extensions/avx.cc.h
index 51328d5..88c0020 100644
--- a/src/include/operation/extensions/avx.cc.h
+++ b/src/include/operation/extensions/avx.cc.h
@@ -16,9 +16,9 @@
 
 namespace CNORXZ
 {
-    /***********************
-     *   PlusCC / PlusCX   *
-     ***********************/
+    /*=====================+
+     |   PlusCC / PlusCX   |
+     +=====================*/
     
     inline decltype(auto)
     PlusCC<Double,Double,AVX::ND>::eval(const Consecutive<Double,AVX::ND>& a,
@@ -80,9 +80,9 @@ namespace CNORXZ
 	return o;
     }
 
-    /*************************
-     *   MinusCC / MinusCX   *
-     *************************/
+    /*=======================+
+     |   MinusCC / MinusCX   |
+     +=======================*/
 
     inline decltype(auto)
     MinusCC<Double,Double,AVX::ND>::eval(const Consecutive<Double,AVX::ND>& a,
@@ -144,9 +144,9 @@ namespace CNORXZ
 	return o;
     }
 
-    /***********************************
-     *   MultipliesCC / MultipliesCX   *
-     ***********************************/
+    /*=================================+
+     |   MultipliesCC / MultipliesCX   |
+     +=================================*/
 
     inline decltype(auto)
     MultipliesCC<Double,Double,AVX::ND>::eval(const Consecutive<Double,AVX::ND>& a,
@@ -210,9 +210,9 @@ namespace CNORXZ
     }
     
     
-    /*****************************
-     *   DividesCC / DividesCX   *
-     *****************************/
+    /*===========================+
+     |   DividesCC / DividesCX   |
+     +===========================*/
 
     inline decltype(auto)
     DividesCC<Double,Double,AVX::ND>::eval(const Consecutive<Double,AVX::ND>& a,
diff --git a/src/include/operation/extensions/reg.cc.h b/src/include/operation/extensions/reg.cc.h
index 39465d0..f3d85fb 100644
--- a/src/include/operation/extensions/reg.cc.h
+++ b/src/include/operation/extensions/reg.cc.h
@@ -120,9 +120,9 @@ namespace CNORXZ
 	return consecFuncAI<F,Dst,Args...>(f, dst, args..., std::make_index_sequence<N>{});
     }
 
-    /******************************
-     *   basic operations: plus   *
-     ******************************/
+    /*============================+
+     |   basic operations: plus   |
+     +============================*/
 
     template <typename T, typename U, SizeT N>
     constexpr decltype(auto)
@@ -156,9 +156,9 @@ namespace CNORXZ
 	return consecFuncA<N>( [](auto& x, const auto& y) { return x += y; }, o, a );
     }
 
-    /*******************************
-     *   basic operations: minus   *
-     *******************************/
+    /*=============================+
+     |   basic operations: minus   |
+     +=============================*/
 
     template <typename T, typename U, SizeT N>
     constexpr decltype(auto) MinusCC<T,U,N>::eval(const Consecutive<T,N>& a, const Consecutive<U,N>& b)
@@ -190,9 +190,9 @@ namespace CNORXZ
 	return consecFuncA<N>( [](auto& x, const auto& y) { return x -= y; }, o, a );
     }
 
-    /***********************************
-     *   basic operations: muliplies   *
-     ***********************************/
+    /*=================================+
+     |   basic operations: muliplies   |
+     +=================================*/
 
     template <typename T, typename U, SizeT N>
     constexpr decltype(auto) MultipliesCC<T,U,N>::eval(const Consecutive<T,N>& a, const Consecutive<U,N>& b)
@@ -224,9 +224,9 @@ namespace CNORXZ
 	return consecFuncA<N>( [](const auto& x, const auto& y) { return x *= y; }, o, a );
     }
 
-    /*********************************
-     *   basic operations: divides   *
-     *********************************/
+    /*===============================+
+     |   basic operations: divides   |
+     +===============================*/
 
     template <typename T, typename U, SizeT N>
     constexpr decltype(auto) DividesCC<T,U,N>::eval(const Consecutive<T,N>& a, const Consecutive<U,N>& b)
diff --git a/src/include/operation/extensions/reg.h b/src/include/operation/extensions/reg.h
index 89cf05a..8cbf699 100644
--- a/src/include/operation/extensions/reg.h
+++ b/src/include/operation/extensions/reg.h
@@ -43,9 +43,9 @@ namespace CNORXZ
     template <typename T, SizeT N>
     struct consecutive_size<Consecutive<T,N>> { static constexpr SizeT value = N; };
 
-    /****************************************
-     *   consecutive generating functions   *
-     ****************************************/
+    /*======================================+
+     |   consecutive generating functions   |
+     +======================================*/
 
     template <typename T, class EPosT, SizeT... Is>
     inline decltype(auto) vregi(const T* d, const EPosT& pos, std::index_sequence<Is...> is);
@@ -56,9 +56,9 @@ namespace CNORXZ
     template <typename T, class EPosT>
     inline decltype(auto) vreg(T* d, const EPosT& pos);
 
-    /******************
-     *   ConsecFunc   *
-     ******************/
+    /*================+
+     |   ConsecFunc   |
+     +================*/
 
     template <SizeT I, typename T>
     constexpr decltype(auto) consecGet(const T& a);
@@ -86,9 +86,9 @@ namespace CNORXZ
     template <SizeT N, class F, typename Dst, typename... Args>
     constexpr Dst& consecFuncA(const F& f, Dst& dst, const Args&... args);
 
-    /******************************
-     *   basic operations: plus   *
-     ******************************/
+    /*============================+
+     |   basic operations: plus   |
+     +============================*/
 
     template <typename T, typename U, SizeT N>
     struct PlusCC
@@ -133,9 +133,9 @@ namespace CNORXZ
     constexpr Consecutive<T,N>& operator+=(Consecutive<T,N>& o, const U& a)
     { return PlusCX<T,U,N>::aeval(o,a); }
 
-    /*******************************
-     *   basic operations: minus   *
-     *******************************/
+    /*=============================+
+     |   basic operations: minus   |
+     +=============================*/
 
     template <typename T, typename U, SizeT N>
     struct MinusCC
@@ -180,9 +180,9 @@ namespace CNORXZ
     constexpr Consecutive<T,N>& operator-=(Consecutive<T,N>& o, const U& a)
     { return MinusCX<T,U,N>::eval(o,a); }
 
-    /***********************************
-     *   basic operations: muliplies   *
-     ***********************************/
+    /*=================================+
+     |   basic operations: muliplies   |
+     +=================================*/
 
     template <typename T, typename U, SizeT N>
     struct MultipliesCC
@@ -227,9 +227,9 @@ namespace CNORXZ
     constexpr Consecutive<T,N>& operator*=(Consecutive<T,N>& o, const U& a)
     { return MultipliesCX<T,U,N>::eval(o,a); }
 
-    /*********************************
-     *   basic operations: divides   *
-     *********************************/
+    /*===============================+
+     |   basic operations: divides   |
+     +===============================*/
 
     template <typename T, typename U, SizeT N>
     struct DividesCC
diff --git a/src/include/ranges/crange.cc.h b/src/include/ranges/crange.cc.h
index 6a8e3be..843b90b 100644
--- a/src/include/ranges/crange.cc.h
+++ b/src/include/ranges/crange.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/ranges/crange.cc.h
-   @brief ...
+   @brief CRange and CIndex template implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/ranges/dindex.cc.h b/src/include/ranges/dindex.cc.h
index f752bed..91668b6 100644
--- a/src/include/ranges/dindex.cc.h
+++ b/src/include/ranges/dindex.cc.h
@@ -2,8 +2,7 @@
 /**
    
    @file include/ranges/dindex.cc.h
-   @brief ...
-
+   @brief Dynamic index template implementations.
 
    Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
diff --git a/src/include/ranges/dindex.h b/src/include/ranges/dindex.h
index 82cab3c..f70a56c 100644
--- a/src/include/ranges/dindex.h
+++ b/src/include/ranges/dindex.h
@@ -2,7 +2,7 @@
 /**
    
    @file include/ranges/dindex.h
-   @brief DIndex declaration.
+   @brief Dynamic index declaration.
 
    Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
diff --git a/src/include/ranges/eindex.cc.h b/src/include/ranges/eindex.cc.h
index e0c31c1..a48a8c3 100644
--- a/src/include/ranges/eindex.cc.h
+++ b/src/include/ranges/eindex.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/ranges/eindex.cc.h
-   @brief ...
+   @brief Extension index implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/ranges/eindex.h b/src/include/ranges/eindex.h
index f7e2c81..a0e1e3e 100644
--- a/src/include/ranges/eindex.h
+++ b/src/include/ranges/eindex.h
@@ -2,8 +2,7 @@
 /**
    
    @file include/ranges/eindex.h
-   @brief ...
-
+   @brief Extension index declaration.
 
    Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
diff --git a/src/include/ranges/index_base.cc.h b/src/include/ranges/index_base.cc.h
index 4ba1774..c037b54 100644
--- a/src/include/ranges/index_base.cc.h
+++ b/src/include/ranges/index_base.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/ranges/index_base.cc.h
-   @brief ...
+   @brief Index base template implementation.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
@@ -17,9 +16,9 @@
 
 namespace CNORXZ
 {
-    /**********************
-     *   IndexInterface   *
-     **********************/
+    /*====================+
+     |   IndexInterface   |
+     +====================*/
 
     template <class I, typename MetaType>
     IndexInterface<I,MetaType>::IndexInterface()
@@ -113,9 +112,9 @@ namespace CNORXZ
     }
 
 
-    /****************************
-     *   Non-member functions   *
-     ****************************/
+    /*==========================+
+     |   Non-member functions   |
+     +==========================*/
     
     template <class I, typename MetaType>
     IndexPtr<I,MetaType>& operator++(const IndexPtr<I,MetaType>& i)
diff --git a/src/include/ranges/index_base.h b/src/include/ranges/index_base.h
index 4668af8..e9ca374 100644
--- a/src/include/ranges/index_base.h
+++ b/src/include/ranges/index_base.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/ranges/index_base.h
-   @brief ...
+   @brief Index base declaration.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/ranges/index_format.cc.h b/src/include/ranges/index_format.cc.h
index b5fa845..7acf07c 100644
--- a/src/include/ranges/index_format.cc.h
+++ b/src/include/ranges/index_format.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/ranges/index_format.cc.h
-   @brief ...
+   @brief Index formats implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
@@ -17,9 +16,9 @@
 
 namespace CNORXZ
 {
-    /***************
-     *   MFormat   *
-     ***************/
+    /*=============+
+     |   MFormat   |
+     +=============*/
     
     template <SizeT N>
     constexpr MFormat<N>::MFormat(const Arr<UPos,N>& b) :
@@ -61,9 +60,9 @@ namespace CNORXZ
     }
 
     
-    /****************
-     *   GMFormat   *
-     ****************/
+    /*==============+
+     |   GMFormat   |
+     +==============*/
 
     template <class... PosT>
     constexpr GMFormat<PosT...>::GMFormat(const Tuple<PosT...>& b) :
@@ -115,9 +114,9 @@ namespace CNORXZ
 	return GMFormat(std::move(std::make_tuple(ps...)));
     }
 
-    /***************
-     *   YFormat   *
-     ***************/
+    /*=============+
+     |   YFormat   |
+     +=============*/
 
     template <class FormatT>
     YFormat::YFormat(const FormatT& f) : mB(f.size())
diff --git a/src/include/ranges/index_mul.cc.h b/src/include/ranges/index_mul.cc.h
index 0395560..dbc1e7a 100644
--- a/src/include/ranges/index_mul.cc.h
+++ b/src/include/ranges/index_mul.cc.h
@@ -2,8 +2,7 @@
 /**
    
    @file include/ranges/index_mul.cc.h
-   @brief ...
-
+   @brief Index multiplication template implementation.
 
    Copyright (c) 2022 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
@@ -18,9 +17,9 @@
 namespace CNORXZ
 {
 
-    /*********************
-     *   MIndexSptrMul   *
-     *********************/
+    /*===================+
+     |   MIndexSptrMul   |
+     +===================*/
 
     template <class BlockT, class... Indices, class I, SizeT... Is>
     decltype(auto) MIndexSptrMul::evalMX(const Sptr<GMIndex<BlockT,Indices...>>& a,
@@ -52,9 +51,9 @@ namespace CNORXZ
     }
 
     
-    /*****************
-     *   operator*   *
-     *****************/
+    /*===============+
+     |   operator*   |
+     +===============*/
 
     template <class I1, typename Meta1, class I2, typename Meta2>
     inline decltype(auto) operator*(const IndexInterface<I1,Meta1>& a,
@@ -122,9 +121,9 @@ namespace CNORXZ
 	return a.mul(b);
     }
 
-    /***************
-     *   iptrMul   *
-     ***************/
+    /*=============+
+     |   iptrMul   |
+     +=============*/
 
     template <class I1, class I2>
     decltype(auto) iptrMul(const Sptr<I1>& a, const Sptr<I2>& b)
diff --git a/src/include/ranges/index_pack.cc.h b/src/include/ranges/index_pack.cc.h
index f8b05f5..c8be6aa 100644
--- a/src/include/ranges/index_pack.cc.h
+++ b/src/include/ranges/index_pack.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/ranges/index_pack.cc.h
-   @brief ...
+   @brief Index pack template implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
@@ -17,9 +16,9 @@
 
 namespace CNORXZ
 {
-    /*************
-     *   SPack   *
-     *************/
+    /*===========+
+     |   SPack   |
+     +===========*/
 
     template <class... Indices>
     constexpr SPack<Indices...>::SPack(const Sptr<Indices>&... is) :
@@ -96,9 +95,9 @@ namespace CNORXZ
 	return lex();
     }
 
-    /**************************
-     *   SPack (non-member)   *
-     **************************/
+    /*========================+
+     |   SPack (non-member)   |
+     +========================*/
 
     template <class... Indices>
     constexpr decltype(auto) spack(const Indices&... inds)
@@ -114,9 +113,9 @@ namespace CNORXZ
 	return SPack<Indices...>( inds... );
     }
 
-    /*************
-     *   DPack   *
-     *************/
+    /*===========+
+     |   DPack   |
+     +===========*/
 
     template <class... Indices>
     DPack::DPack(const SPack<Indices...>& p) :
@@ -127,9 +126,9 @@ namespace CNORXZ
     {}
 	
 
-    /**************************
-     *   DPack (non-member)   *
-     **************************/
+    /*========================+
+     |   DPack (non-member)   |
+     +========================*/
 
     template <class... Indices>
     DPack dpack(const Indices&... inds)
diff --git a/src/include/ranges/lindex.cc.h b/src/include/ranges/lindex.cc.h
index 4dc5dab..5ec5342 100644
--- a/src/include/ranges/lindex.cc.h
+++ b/src/include/ranges/lindex.cc.h
@@ -2,8 +2,7 @@
 /**
    
    @file include/ranges/lindex.cc.h
-   @brief ...
-
+   @brief LIndex implementations.
 
    Copyright (c) 2022 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
diff --git a/src/include/ranges/range_base.cc.h b/src/include/ranges/range_base.cc.h
index 779d871..d354056 100644
--- a/src/include/ranges/range_base.cc.h
+++ b/src/include/ranges/range_base.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/ranges/range_base.cc.h
-   @brief ...
+   @brief RangeBase template implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/ranges/ranges.cc.h b/src/include/ranges/ranges.cc.h
index 9f4f18f..5110bca 100644
--- a/src/include/ranges/ranges.cc.h
+++ b/src/include/ranges/ranges.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/ranges/ranges.cc.h
-   @brief ...
+   @brief Ranges template implementation main header
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
diff --git a/src/include/ranges/srange.cc.h b/src/include/ranges/srange.cc.h
index a5e9e55..7c9dfde 100644
--- a/src/include/ranges/srange.cc.h
+++ b/src/include/ranges/srange.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/ranges/srange.cc.h
-   @brief ...
+   @brief SRange, SRangeFactory and SIndex implementation.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
@@ -18,9 +17,9 @@
 
 namespace CNORXZ
 {
-    /**************
-     *   SIndex   *
-     **************/
+    /*============+
+     |   SIndex   |
+     +============*/
 
     template <typename MetaT, SizeT S>
     SIndex<MetaT,S>::SIndex(const RangePtr& range, SizeT pos) :
@@ -213,9 +212,9 @@ namespace CNORXZ
     }
 
     
-    /*********************
-     *   SRangeFactory   *
-     *********************/
+    /*===================+
+     |   SRangeFactory   |
+     +===================*/
 
     template <typename MetaType, SizeT S>
     SRangeFactory<MetaType,S>::SRangeFactory(const Arr<MetaType,S>& space) :
@@ -248,9 +247,9 @@ namespace CNORXZ
 	}
     }
 
-    /**************
-     *   SRange   *
-     **************/
+    /*============+
+     |   SRange   |
+     +============*/
     
     template <typename MetaType, SizeT S>
     SRange<MetaType,S>::SRange(const Arr<MetaType,S>& space) :
@@ -338,9 +337,9 @@ namespace CNORXZ
 	return Vector<Uuid> { this->id() };
     }
 
-    /*******************
-     *   Range Casts   *
-     *******************/
+    /*=================+
+     |   Range Casts   |
+     +=================*/
 
     template <typename MetaType, SizeT S>
     Sptr<SRange<MetaType,S>> RangeCast<SRange<MetaType,S>>::func(const RangePtr& r)
diff --git a/src/include/ranges/urange.cc.h b/src/include/ranges/urange.cc.h
index 603d096..7b868b5 100644
--- a/src/include/ranges/urange.cc.h
+++ b/src/include/ranges/urange.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/ranges/urange.cc.h
-   @brief ...
+   @brief URange, URangeFactory and UIndex implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
@@ -25,9 +24,9 @@
 
 namespace CNORXZ
 {
-    /*****************
-     *    UIndex     *	     
-     *****************/
+    /*===============+
+     |    UIndex     |	     
+     +===============*/
 
     template <typename MetaT>
     UIndex<MetaT>::UIndex(const RangePtr& range, SizeT pos) :
@@ -222,9 +221,9 @@ namespace CNORXZ
 	return iptrMul(a, b);
     }
 
-    /**********************
-     *   URangeFactory    *
-     **********************/
+    /*====================+
+     |   URangeFactory    |
+     +====================*/
 
     template <typename MetaT>
     URangeFactory<MetaT>::URangeFactory(const Vector<MetaT>& space) :
@@ -257,9 +256,9 @@ namespace CNORXZ
 	}
     }
     
-    /***************
-     *   URange    *
-     ***************/
+    /*=============+
+     |   URange    |
+     +=============*/
     
     template <typename MetaT>
     URange<MetaT>::URange(const Vector<MetaT>& space) :
@@ -350,9 +349,9 @@ namespace CNORXZ
 	return Vector<Uuid> { this->id() };
     }
 
-    /*******************
-     *   Range Casts   *
-     *******************/
+    /*=================+
+     |   Range Casts   |
+     +=================*/
 
     template <typename MetaT>
     struct URangeCast
diff --git a/src/include/ranges/xindex.cc.h b/src/include/ranges/xindex.cc.h
index ff5db88..f72e7c2 100644
--- a/src/include/ranges/xindex.cc.h
+++ b/src/include/ranges/xindex.cc.h
@@ -2,10 +2,9 @@
 /**
    
    @file include/ranges/xindex.cc.h
-   @brief ...
+   @brief XIndexBase and XIndex template implementations.
 
-
-   Copyright (c) 2022 Christian Zimmermann. All rights reserved.
+   Copyright (c) 2024 Christian Zimmermann. All rights reserved.
    Mail: chizeta@f3l.de
    
 **/
@@ -18,9 +17,9 @@
 namespace CNORXZ
 {
 
-    /**************
-     *   XIndex   *
-     **************/
+    /*============+
+     |   XIndex   |
+     +============*/
     
     template <class Index, typename Meta>
     XIndex<Index,Meta>::XIndex(const IndexPtr<Index,Meta>& i) :
diff --git a/src/include/xpr/for.cc.h b/src/include/xpr/for.cc.h
index ba6a07e..5b95eb5 100644
--- a/src/include/xpr/for.cc.h
+++ b/src/include/xpr/for.cc.h
@@ -19,9 +19,9 @@
 namespace CNORXZ
 {
 
-    /***********
-     *   For   *
-     ***********/
+    /*=========+
+     |   For   |
+     +=========*/
     
     template <SizeT L, class Xpr, class F>
     constexpr For<L,Xpr,F>::For(SizeT size, const IndexId<L>& id, const Xpr& xpr, F&& f) :
@@ -83,9 +83,9 @@ namespace CNORXZ
 	return mXpr.rootSteps(id);
     }
 
-    /************************
-     *   For (non-member)   *
-     ************************/
+    /*======================+
+     |   For (non-member)   |
+     +======================*/
 
     template <SizeT L, class Xpr, class F>
     constexpr decltype(auto) mkFor(SizeT size, const IndexId<L>& id, const Xpr& xpr, F&& f)
@@ -99,9 +99,9 @@ namespace CNORXZ
 	return For<L,Xpr>(size, id, xpr, NoF {});
     }
 
-    /************
-     *   SFor   *
-     ************/
+    /*==========+
+     |   SFor   |
+     +==========*/
 
     template <SizeT N, SizeT L, class Xpr, class F>
     constexpr SFor<N,L,Xpr,F>::SFor(const IndexId<L>& id, const Xpr& xpr, F&& f) :
@@ -203,9 +203,9 @@ namespace CNORXZ
 	return;
     }
 
-    /*************************
-     *   SFor (non-member)   *
-     *************************/
+    /*=======================+
+     |   SFor (non-member)   |
+     +=======================*/
 
     template <SizeT N, SizeT L, class Xpr, class F>
     constexpr decltype(auto) mkSFor(const IndexId<L>& id, const Xpr& xpr, F&& f)
@@ -219,9 +219,9 @@ namespace CNORXZ
 	return SFor<N,L,Xpr>(id, xpr, NoF {});
     }
     
-    /************
-     *   PFor   *
-     ************/
+    /*==========+
+     |   PFor   |
+     +==========*/
     
     template <SizeT L1, SizeT L2, class Xpr, class F>
     constexpr PFor<L1,L2,Xpr,F>::PFor(SizeT size, const IndexId<L1>& id1, const IndexId<L2>& id2,
@@ -291,9 +291,9 @@ namespace CNORXZ
 	return mXpr.rootSteps(id);
     }
 
-    /*************************
-     *   PFor (non-member)   *
-     *************************/
+    /*=======================+
+     |   PFor (non-member)   |
+     +=======================*/
 
     template <SizeT L1, SizeT L2, class Xpr, class F>
     constexpr decltype(auto) mkPFor(SizeT size, const IndexId<L1>& id1, const IndexId<L2>& id2,
@@ -309,9 +309,9 @@ namespace CNORXZ
 	return PFor<L1,L2,Xpr>(size, id1, id2, xpr, NoF {});
     }
 
-    /************
-     *   TFor   *
-     ************/
+    /*==========+
+     |   TFor   |
+     +==========*/
 
     template <SizeT L, class Xpr, class F>
     constexpr TFor<L,Xpr,F>::TFor(SizeT size, const IndexId<L>& id, const Xpr& xpr, F&& f) :
@@ -399,9 +399,9 @@ namespace CNORXZ
     }
 
 
-    /************
-     *   EFor   *
-     ************/
+    /*==========+
+     |   EFor   |
+     +==========*/
 
     template <SizeT N, SizeT L, class Xpr, class F>
     constexpr EFor<N,L,Xpr,F>::EFor(const IndexId<L>& id, const Xpr& xpr, F&& f) :
diff --git a/src/include/xpr/pos_type.cc.h b/src/include/xpr/pos_type.cc.h
index f4ade10..7fead30 100644
--- a/src/include/xpr/pos_type.cc.h
+++ b/src/include/xpr/pos_type.cc.h
@@ -18,9 +18,9 @@
 namespace CNORXZ
 {
 
-    /************
-     *   SPos   *
-     ************/
+    /*==========+
+     |   SPos   |
+     +==========*/
 
     template <SizeT N>
     constexpr SizeT SPos<N>::size() const
@@ -116,9 +116,9 @@ namespace CNORXZ
 	return val();
     }
 
-    /************
-     *   UPos   *
-     ************/
+    /*==========+
+     |   UPos   |
+     +==========*/
 
     constexpr UPos::UPos(SizeT ext) : mExt(ext) {}
     
@@ -183,9 +183,9 @@ namespace CNORXZ
 	return val();
     }
 
-    /************
-     *   FPos   *
-     ************/
+    /*==========+
+     |   FPos   |
+     +==========*/
 
     inline FPos::FPos(SizeT ext, const SizeT* map) : mExt(ext), mMap(map) {}
     
@@ -234,9 +234,9 @@ namespace CNORXZ
 	return val();
     }
 
-    /*************
-     *   SFPos   *
-     *************/
+    /*===========+
+     |   SFPos   |
+     +===========*/
 
     template <SizeT N, SizeT... Ms>
     Arr<SizeT,sizeof...(Ms)> SFPos<N,Ms...>::sMs = { Ms... };
@@ -320,9 +320,9 @@ namespace CNORXZ
 	return val();
     }
 
-    /************
-     *   MPos   *
-     ************/
+    /*==========+
+     |   MPos   |
+     +==========*/
 
     template <class BPosT, class NPosT>
     constexpr MPos<BPosT,NPosT>::MPos()
@@ -411,9 +411,9 @@ namespace CNORXZ
 	return extend(a);
     }
     
-    /************
-     *   DPos   *
-     ************/
+    /*==========+
+     |   DPos   |
+     +==========*/
 
     inline DPos::DPos(Uptr<VPosBase>&& a) :
 	ObjHandle<VPosBase>(std::forward<Uptr<VPosBase>>(a))
@@ -516,9 +516,9 @@ namespace CNORXZ
 	return val();
     }
 
-    /***************
-     *   DPosRef   *
-     ***************/
+    /*=============+
+     |   DPosRef   |
+     +=============*/
 
     inline DPosRef::DPosRef(const VPosBase* p) : mP(p) {}
 
@@ -597,9 +597,9 @@ namespace CNORXZ
 	return val();
     }
     
-    /************
-     *   EPos   *
-     ************/
+    /*==========+
+     |   EPos   |
+     +==========*/
 
     template <class BPosT, class... OPosTs>
     constexpr EPos<BPosT,OPosTs...>::EPos(const BPosT& b, const OPosTs&... os) :
@@ -689,9 +689,9 @@ namespace CNORXZ
 	return OEPosT(BPosT::next(), std::get<Is>(mP).next()...);
     }
 
-    /*********************************
-     *   Traits and Helper-Classes   *
-     *********************************/
+    /*===============================+
+     |   Traits and Helper-Classes   |
+     +===============================*/
 
     template <class BPosT, class OPosT, SizeT N>
     decltype(auto) MkEPos<BPosT,OPosT,N>::mk(const BPosT& a, const OPosT& b)
diff --git a/src/include/xpr/pos_type.h b/src/include/xpr/pos_type.h
index 1817726..09f300e 100644
--- a/src/include/xpr/pos_type.h
+++ b/src/include/xpr/pos_type.h
@@ -306,9 +306,9 @@ namespace CNORXZ
 	constexpr decltype(auto) get() const;
     };
 
-    /*********************************
-     *   Traits and Helper-Classes   *
-     *********************************/
+    /*===============================+
+     |   Traits and Helper-Classes   |
+     +===============================*/
     
     template <class T>
     struct is_pos_type { CXZ_CVAL_FALSE; };
@@ -380,9 +380,9 @@ namespace CNORXZ
     template <class BPosT, class OPosT, SizeT... Is>
     decltype(auto) mkiEPos(const BPosT& a, const OPosT& b, std::index_sequence<Is...> is);
 
-    /**************************************************
-     *   Traits and Helper-Classes: Specializations   *
-     **************************************************/
+    /*================================================+
+     |   Traits and Helper-Classes: Specializations   |
+     +================================================*/
 
     template <SizeT N> struct is_pos_type<SPos<N>> { CXZ_CVAL_TRUE; };
     template <SizeT N> struct is_scalar_pos_type<SPos<N>> { CXZ_CVAL_TRUE; };
diff --git a/src/include/xpr/vpos_type.cc.h b/src/include/xpr/vpos_type.cc.h
index 4df2dc1..bb80df1 100644
--- a/src/include/xpr/vpos_type.cc.h
+++ b/src/include/xpr/vpos_type.cc.h
@@ -17,9 +17,9 @@
 
 namespace CNORXZ
 {
-    /************
-     *   VPos   *
-     ************/
+    /*==========+
+     |   VPos   |
+     +==========*/
 
     template <class PosT>
     VPos<PosT>::VPos(const PosT& a) :
@@ -77,9 +77,9 @@ namespace CNORXZ
 	return std::make_unique<VPos<OPosT>>( (*this)(UPos(a->vval())) );
     }
 
-    /******************
-     *   VPos<MPos>   *
-     ******************/
+    /*================+
+     |   VPos<MPos>   |
+     +================*/
 
     template <class PosT1, class PosT2>
     VPos<MPos<PosT1,PosT2>>::VPos(const VPos& a) :
@@ -168,9 +168,9 @@ namespace CNORXZ
 	return std::make_unique<VPos<OPosT>>( (*this)(UPos(a->vval())) );
     }
 
-    /***************
-     *   VPosRef   *
-     ***************/
+    /*=============+
+     |   VPosRef   |
+     +=============*/
 
     template <class PosT>
     VPosRef<PosT>::VPosRef(const PosT* c) :
@@ -228,9 +228,9 @@ namespace CNORXZ
 	return std::make_unique<VPos<OPosT>>( (*mC)(UPos(a->vval())) );
     }
 
-    /*********************
-     *   VPosRef<MPos>   *
-     *********************/
+    /*===================+
+     |   VPosRef<MPos>   |
+     +===================*/
 
     template <class PosT1, class PosT2>
     VPosRef<MPos<PosT1,PosT2>>::VPosRef(const MPos<PosT1,PosT2>* c) :
@@ -298,9 +298,9 @@ namespace CNORXZ
 	return std::make_unique<VPos<OPosT>>( (*mC)(UPos(a->vval())) );
     }
     
-    /*******************
-     *   PosFromVPos   *
-     *******************/
+    /*=================+
+     |   PosFromVPos   |
+     +=================*/
 
     template <class PosT>
     inline decltype(auto) PosFromVPos<PosT>::make(const VPosBase* a)
diff --git a/src/include/xpr/xpr_base.cc.h b/src/include/xpr/xpr_base.cc.h
index 43fdf6c..f51afa2 100644
--- a/src/include/xpr/xpr_base.cc.h
+++ b/src/include/xpr/xpr_base.cc.h
@@ -17,9 +17,9 @@
 namespace CNORXZ
 {
     
-    /************
-     *   VXpr   *
-     ************/
+    /*==========+
+     |   VXpr   |
+     +==========*/
     
     template <typename T, class Xpr>
     VXpr<T,Xpr>::VXpr(const XprInterface<Xpr>& a) :
@@ -50,9 +50,9 @@ namespace CNORXZ
 	return DPos(this->rootSteps(id));
     }
     
-    /************
-     *   DXpr   *
-     ************/
+    /*==========+
+     |   DXpr   |
+     +==========*/
 
     template <typename T>
     template <class Xpr>
diff --git a/src/lib/ranges/range_base.cc b/src/lib/ranges/range_base.cc
index 749c5f7..eb20116 100644
--- a/src/lib/ranges/range_base.cc
+++ b/src/lib/ranges/range_base.cc
@@ -15,9 +15,9 @@
 namespace CNORXZ
 {
     
-    /*************************
-     *   RangeFactoryBase    *
-     *************************/
+    /*=======================+
+     |   RangeFactoryBase    |
+     +=======================*/
 
     Map<SizeT,Map<Vector<Uuid>,RangePtr>> RangeFactoryBase::sCreated;
     
@@ -56,9 +56,9 @@ namespace CNORXZ
 	return rx;
     }
 
-    /******************
-     *   RangeBase    *
-     ******************/
+    /*================+
+     |   RangeBase    |
+     +================*/
 
     RangeBase::RangeBase()
     {
@@ -101,9 +101,9 @@ namespace CNORXZ
 	return this->index(this->size());
     }
 
-    /****************************
-     *   Non-member functions   *
-     ****************************/
+    /*==========================+
+     |   Non-member functions   |
+     +==========================*/
 
     RangePack::operator RangePtr() const
     {
diff --git a/src/lib/ranges/yrange.cc b/src/lib/ranges/yrange.cc
index 0f799b9..4a4ac16 100644
--- a/src/lib/ranges/yrange.cc
+++ b/src/lib/ranges/yrange.cc
@@ -14,9 +14,9 @@
 
 namespace CNORXZ
 {
-    /*************************
-     *   YIndex (private)    *
-     *************************/
+    /*=======================+
+     |   YIndex (private)    |
+     +=======================*/
 
     inline DPack YIndex::mkIndices() const
     {
@@ -130,9 +130,9 @@ namespace CNORXZ
     }
     
     
-    /***************
-     *   YIndex    *
-     ***************/
+    /*=============+
+     |   YIndex    |
+     +=============*/
 
     YIndex::YIndex(const YIndex& i) :
 	IndexInterface<YIndex,Vector<DType>>(i),
@@ -517,9 +517,9 @@ namespace CNORXZ
     }
 
 
-    /****************************
-     *   non-member functions   *
-     ****************************/
+    /*==========================+
+     |   non-member functions   |
+     +==========================*/
 
     YIndex yindex(const DPack& pack)
     {
@@ -541,9 +541,9 @@ namespace CNORXZ
 	return std::make_shared<YIndex>(is);
     }
 
-    /**********************
-     *   YRangeFactory    *
-     **********************/
+    /*====================+
+     |   YRangeFactory    |
+     +====================*/
 
     YRangeFactory::YRangeFactory(const Vector<RangePtr>& rvec) :
 	mRVec(rvec) {}
@@ -570,9 +570,9 @@ namespace CNORXZ
 	}
     }
 
-    /***************
-     *   YRange    *
-     ***************/
+    /*=============+
+     |   YRange    |
+     +=============*/
 
     RangePtr YRange::sub(SizeT i) const
     {
@@ -659,18 +659,18 @@ namespace CNORXZ
     
     YRange::YRange(Vector<RangePtr>&& rvec) : mRVec(std::forward<Vector<RangePtr>>(rvec)) {}
 
-    /****************************
-     *   non-member functions   *
-     ****************************/
+    /*==========================+
+     |   non-member functions   |
+     +==========================*/
 
     RangePtr yrange(const Vector<RangePtr>& rs)
     {
 	return YRangeFactory(rs).create();
     }
 
-    /*******************
-     *   Range Casts   *
-     *******************/
+    /*=================+
+     |   Range Casts   |
+     +=================*/
 
     Sptr<YRange> RangeCast<YRange>::func(const RangePtr& r)
     {
diff --git a/src/opt/cereal/include/cer_ranges.cc.h b/src/opt/cereal/include/cer_ranges.cc.h
index 7180e99..4f23494 100644
--- a/src/opt/cereal/include/cer_ranges.cc.h
+++ b/src/opt/cereal/include/cer_ranges.cc.h
@@ -22,9 +22,9 @@
 
 namespace CNORXZ
 {
-    /**************
-     *    save    *
-     **************/
+    /*============+
+     |    save    |
+     +============*/
 
     template <class Archive>
     void save(Archive& ar, const Uuid& id)
@@ -61,9 +61,9 @@ namespace CNORXZ
 	ar(cereal::make_nvp("sub", mRVec));
     }
 
-    /**************
-     *    load    *
-     **************/
+    /*============+
+     |    load    |
+     +============*/
     
     template <class Archive>
     void load(Archive& ar, Uuid& id)
-- 
2.45.2


From b20de211ef83d4fa7d49d886ba2457c84ffe0baf Mon Sep 17 00:00:00 2001
From: Christian Zimmermann <christian.zimmermann@ur.de>
Date: Sat, 3 Feb 2024 23:35:29 +0100
Subject: [PATCH 6/9] remove some code that has been already commented out

---
 src/include/array/array_base.cc.h    | 2 --
 src/opt/hdf5/include/h5_dataset.cc.h | 2 +-
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/include/array/array_base.cc.h b/src/include/array/array_base.cc.h
index cd71cdf..dcc1779 100644
--- a/src/include/array/array_base.cc.h
+++ b/src/include/array/array_base.cc.h
@@ -181,7 +181,6 @@ namespace CNORXZ
     typename CArrayBase<T>::const_iterator CArrayBase<T>::itLexSave(const Acc& acc) const
     {
 	CXZ_ASSERT(acc.lex() < this->size(), "index out of range");
-	//CXZ_ASSERT(false, "IMPLEMENT CHECKS!!");
 	// check further compatibility of index/range format!!!
 	return begin() + acc.lex();
     }
@@ -374,7 +373,6 @@ namespace CNORXZ
     typename ArrayBase<T>::iterator ArrayBase<T>::itLexSave(const Acc& acc)
     {
 	CXZ_ASSERT(acc.lex() < this->size(), "index out of range");
-	//CXZ_ASSERT(false, "IMPLEMENT CHECKS!!");
 	// check further compatibility of index/range format!!!
 	return begin() + acc.lex();
     }
diff --git a/src/opt/hdf5/include/h5_dataset.cc.h b/src/opt/hdf5/include/h5_dataset.cc.h
index 9c4aaeb..5ce17ea 100644
--- a/src/opt/hdf5/include/h5_dataset.cc.h
+++ b/src/opt/hdf5/include/h5_dataset.cc.h
@@ -34,7 +34,7 @@ namespace CNORXZ
 		H5Sclose(memspace);
 	    }
 	    else {
-		CXZ_ERROR("IMPLEMENT!!!");
+		CXZ_ERROR("Got array type with non-trivial format; non-contiguous data formats are not supported yet!");
 	    }
 	    return *this;
 	}
-- 
2.45.2


From be312c31bb1068bcab3227332dfa2e7383bcd8ed Mon Sep 17 00:00:00 2001
From: Christian Zimmermann <christian.zimmermann@ur.de>
Date: Sat, 3 Feb 2024 23:55:54 +0100
Subject: [PATCH 7/9] readme minor changes...

---
 README.md       |   2 +-
 cnorxz_logo.png | Bin 45556 -> 45587 bytes
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 3ff29bd..4cc1039 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
 
 ## Description
 
-This library provides a framework for handling multi dimensional containers, their meta data, and several kinds of operations on one or more of them.
+This library provides a framework for handling multi dimensional data containers (arrays or array-like types), their meta data, and several kinds of operations on one or more of them.
 
 ## Build instructions
 
diff --git a/cnorxz_logo.png b/cnorxz_logo.png
index 757ce6c4e75260d70d91e44c7d568ffe789ef775..008dbeb19aed0f2c90598789afeb3b5460820e80 100644
GIT binary patch
literal 45587
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

literal 45556
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
Gg8m0m3QXw$

-- 
2.45.2


From 1261435835c039a7c7e43a66e84924091a52e559 Mon Sep 17 00:00:00 2001
From: Christian Zimmermann <christian.zimmermann@ur.de>
Date: Sun, 4 Feb 2024 00:26:28 +0100
Subject: [PATCH 8/9] correct CMakeLists.txt

---
 CMakeLists.txt | 26 ++++++++++----------------
 1 file changed, 10 insertions(+), 16 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index fb5a89f..9499092 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -1,11 +1,13 @@
-cmake_minimum_required(VERSION 3.0)
+cmake_minimum_required(VERSION 3.5)
   
 project(cnorxz)
 
 # LIB VERSION
 
-set(VERSION_PART "pre")
-set(VERSION_TAG_HASH "6857e3fc7d0af25db3a925791d1cabc6342b930a")
+set(V_MAJOR 0)
+set(V_MINOR 0)
+set(V_PATCH 0)
+set(VERSION "${V_MAJOR}.${V_MINOR}.${V_PATCH}")
 
 # OPTIONS
 
@@ -20,21 +22,13 @@ include(cmake/check_avx.cmake)
 execute_process(COMMAND bash "-c" "git rev-parse HEAD" OUTPUT_VARIABLE GIT_HASH OUTPUT_STRIP_TRAILING_WHITESPACE)
 execute_process(COMMAND bash "-c" "git rev-parse --abbrev-ref HEAD" OUTPUT_VARIABLE GIT_BRANCH OUTPUT_STRIP_TRAILING_WHITESPACE)
 
-# BUILD / CHECK VERSION STRING
+# BUILD VERSION STRING
 
-message(STATUS "${GIT_HASH}")
-message(STATUS "${VERSION_PART}")
-message(STATUS "${VERSION_TAG_HASH}")
-set(VERSION "${VERSION_PART}")
+message(STATUS "git hash = ${GIT_HASH}")
+message(STATUS "git branch = ${GIT_BRANCH}")
 if(NOT ("${GIT_BRANCH}" EQUAL "release"))
-  if(NOT ("${GIT_HASH}" EQUAL "${VERSION_TAG_HASH}"))
-    string(SUBSTRING ${GIT_HASH} 0 7 GIT_HASH_SHORT)
-    set(VERSION "${VERSION}-${GIT_BRANCH}-${GIT_HASH_SHORT}")
-  endif()
-else()
-  if(NOT ("${GIT_HASH}" EQUAL "${VERSION_TAG_HASH}"))
-    message(FATAL_ERROR "version mash-up, do not use, contact maintainer")
-  endif()
+  string(SUBSTRING ${GIT_HASH} 0 7 GIT_HASH_SHORT)
+  set(VERSION "${VERSION}-${GIT_BRANCH}-${GIT_HASH_SHORT}")
 endif()
 message(STATUS "version = ${VERSION}")
 
-- 
2.45.2


From 9b9a8a596e0f225d82c0de1ea3eba75fb88602f3 Mon Sep 17 00:00:00 2001
From: Christian Zimmermann <christian.zimmermann@ur.de>
Date: Sun, 4 Feb 2024 00:39:28 +0100
Subject: [PATCH 9/9] update TODO

---
 TODO | 31 +++++++++++++------------------
 1 file changed, 13 insertions(+), 18 deletions(-)

diff --git a/TODO b/TODO
index f76be28..e5eaef7 100644
--- a/TODO
+++ b/TODO
@@ -1,19 +1,14 @@
 
-include/operation/op_types.cc.h@173: "build and execute assign expression forwarding outer index" [long]
-include/operation/op_types.cc.h@446: "TODO: implement ifor with func arg" [long]
-include/array/array_base.cc.h@35: "TODO: check if container format is trivial" [check]
-include/array/array_base.cc.h@120: "TODO: check if container format is trivial" [check]
-include/array/array_base.cc.h@164: "check further compatibility of index/range format" [check]
-include/array/array_base.cc.h@319: "check further compatibility of index/range format" [check]
-include/base/dtype.cc.h@23: "for tuple use vector<DType>" [comment]
-include/ranges/index_base.cc.h@110: "if this assert never applies, remove mPtrId (-> Defaults)" [long]
-include/ranges/mrange.cc.h@633: "TODO: ZRange (meta and index pos static!)" [long]
-include/ranges/urange.cc.h@366: "else general transform using DType (better than nothing), to be implemented" [urgent]
-include/ranges/urange.cc.h@430: "else general transform using DType (better than nothing), to be implemented" [urgent]
-include/xpr/for.cc.h@314: "check for write access" [check]
-include/ranges/srange.cc.h@292: "TODO: check for selected static sizes of SRange -> return SRange" [long]
-lib/ranges/crange.cc@114: "preliminary solution (TODO: implement xpr that simply returns PosT value)" [long]
-
-opt/hdf5/lib/h5_group.cc@166: "IMPLEMENT" [urgent]
-opt/hdf5/include/h5_group.cc.h@34: "not implemented" [urgent]
-opt/hdf5/lib/h5_table.cc@127: "not implemented" [urgent]
+include/operation/op_types.cc.h@225:    "build and execute assign expression forwarding outer index"
+include/operation/op_types.cc.h@498:    "implement ifor with func arg"
+opt/hdf5/include/h5_content_base.h@23:  "IO save error handling"
+opt/hdf5/lib/h5_dataset.cc@124:         "all sub-ranges explicity"
+lib/ranges/crange.cc@94:                "preliminary solution (TODO: implement xpr that simply returns PosT value)"
+include/ranges/srange.cc.h@307:         "check for selected static sizes of SRange -> return SRange"
+include/xpr/for.cc.h@324:               "check for write access"
+include/base/dtype.cc.h@23:             "for tuple use vector<DType>"
+include/ranges/urange.cc.h@384:         "else general transform using DType (better than nothing), to be implemented"
+include/ranges/urange.cc.h@448:         "else general transform using DType (better than nothing), to be implemented"
+include/array/array_base.cc.h@184:      "check further compatibility of index/range format"
+include/array/array_base.cc.h@376:      "check further compatibility of index/range format"
+include/ranges/index_base.cc.h@109:     "if this assert never applies, remove mPtrId (-> Defaults)"
-- 
2.45.2