From 12e47bd5b5f23beb46711f10498052e6d3b83699 Mon Sep 17 00:00:00 2001
From: Daniel <d.hornung@indiscale.com>
Date: Wed, 18 Aug 2021 09:42:58 +0200
Subject: [PATCH] DOC: SKIP_LINTING and deleted Property copy constructor.

---
 README_SETUP.md         |  2 ++
 include/caosdb/entity.h | 10 ++++++++++
 2 files changed, 12 insertions(+)

diff --git a/README_SETUP.md b/README_SETUP.md
index 147745c..f73190c 100644
--- a/README_SETUP.md
+++ b/README_SETUP.md
@@ -77,6 +77,8 @@ For the tests there is a slightly different setup required (with option `-D CMAK
 1. `mkdir build && cd build/`
 2. `conan install .. -s "compiler.libcxx=libstdc++11"`
 3. `cmake -B . -D CMAKE_BUILD_TYPE=Debug ..`
+   * If your clang-format version is too old, formatting, linting etc. can be skipped:  
+     `cmake -B . -D CMAKE_BUILD_TYPE=Debug -D SKIP_LINTING=ON ..`
 4. `cmake --build .`
 
 ### Run
diff --git a/include/caosdb/entity.h b/include/caosdb/entity.h
index a96126e..8d3aeb9 100644
--- a/include/caosdb/entity.h
+++ b/include/caosdb/entity.h
@@ -558,6 +558,16 @@ private:
  * Container for Properties of Entities.
  *
  * Should only be instantiated and write-accessed by the owning entity.
+ *
+ * Note that iterating over the Property contents only works via references, since the Property copy
+ * constructor is deliberately disabled:
+ *
+ * \code
+ * // Accessing single properties as reference
+ * auto &property = my_properties.at(0);
+ * // Iterating via reference
+ * for (auto &property : my_properties) {...}
+ * \endcode
  */
 class Properties
   : public RepeatedPtrFieldWrapper<Property,
-- 
GitLab