Update docstrings

include/podio/DatamodelRegistry.h

@@ -13,7 +13,7 @@ namespace podio {
 /**
  * Type alias for storing the names of all Relations and VectorMembers for all
  * datatypes of an EDM. Populated for each EDM at code generation time.
- * The structure is of each element in the outer vector is:
+ * The structure for each element in the vector is:
  * - get<0>: The name of the datatype
  * - get<1>: The names of all Relations, where OneToManyRelations comes before
  *   OneToOneRelations (in the order as they appear in the YAML file)
@@ -113,23 +113,34 @@ class DatamodelRegistry {
    * @param name The name of the EDM that should be registered
    * @param definition The datamodel definition from which this EDM has been
    * generated in JSON format
-   * @param relationNames the names of the relations and vector members for all
+   * @param relationNames The names of the relations and vector members for all
    * datatypes that are defined for this EDM
    *
+   * @return The datamodel definition index for this datamodel that can be used
+   * for quicker lookup
    */
   size_t registerDatamodel(std::string name, std::string_view definition,
                            const podio::RelationNameMapping& relationNames);
 
   /**
-   * Get the names of the relations and vector members of a datatype
+   * Get the names of the relations and vector members for a given datatype.
+   *
+   * @param typeName The name of the desired type. Can be obtained e.g. via
+   * collection->getValueTypeName()
+   *
+   * @return Relation and vector member names for this type. The order of the
+   * relations is OneToMany before OneToOne relations in the order they appear
+   * in the YAML file. The order of the VectorMembers is as they appear in the
+   * YAML file
    */
   RelationNames getRelationNames(std::string_view typeName) const;
 
 private:
   DatamodelRegistry() = default;
   /// The stored definitions
   std::vector<std::pair<std::string, std::string_view>> m_definitions{};
-
+  /// The names of the relations and vector members for all datatypes that are
+  /// currently loaded
   std::unordered_map<std::string_view, RelationNames> m_relations{};
 };
 } // namespace podio

src/rootUtils.h

@@ -76,6 +76,7 @@ inline std::string refBranch(const std::string& name, size_t index) {
   return name + "#" + std::to_string(index);
 }
 
+/// The branch name for a relation member of a collection
 inline std::string refBranch(const std::string& name, std::string_view relName) {
   return name + "_" + std::string(relName);
 }
@@ -84,6 +85,7 @@ inline std::string vecBranch(const std::string& name, size_t index) {
   return name + "_" + std::to_string(index);
 }
 
+/// The branch name for a vector member of a collection
 inline std::string vecBranch(const std::string& name, std::string_view vecName) {
   return name + "_" + std::string(vecName);
 }