[Bf-blender-cvs] [e26f0c40026] temp-sybren-usd-patch-02: USD: clearer explanation of when to override `get_object_data_path()`

[Sybren A. Stüvel]

Commit: e26f0c400268bf7cbe46cb3952e691d660926477
Author: Sybren A. Stüvel
Date:   Tue Nov 26 12:43:56 2019 +0100
Branches: temp-sybren-usd-patch-02
https://developer.blender.org/rBe26f0c400268bf7cbe46cb3952e691d660926477

USD: clearer explanation of when to override `get_object_data_path()`

===================================================================

M	source/blender/usd/intern/abstract_hierarchy_iterator.h

===================================================================

diff --git a/source/blender/usd/intern/abstract_hierarchy_iterator.h b/source/blender/usd/intern/abstract_hierarchy_iterator.h
index b1ef6928cd0..5215aa49f46 100644
--- a/source/blender/usd/intern/abstract_hierarchy_iterator.h
+++ b/source/blender/usd/intern/abstract_hierarchy_iterator.h
@@ -161,8 +161,8 @@ class AbstractHierarchyIterator {
   virtual std::string get_id_name(const ID *id) const;
 
   /* Given a HierarchyContext of some Object *, return an export path that is valid for its
-   * object->data. Overriding is probably not necessary if the subclass implements the proper
-   * path_concatenate(). */
+   * object->data. Overriding is necessary when the exported format does NOT expect the object's
+   * data to be a child of the object. */
   virtual std::string get_object_data_path(const HierarchyContext *context) const;
 
  private: