Add a warning to sp-object.h to not use some of the new methods

in SPObject outside of the SP tree

diff --git a/src/sp-object.h b/src/sp-object.h
index 5d3183d9c7245897ad6f2e80930477d2c9bc1b66..8581fd35affd3a645f84466d500106867186c8ab 100644 (file)
--- a/src/sp-object.h
+++ b/src/sp-object.h
@@ -531,6 +531,11 @@ public:
     CollectionPolicy _collection_policy;
     gchar *_label;
     mutable gchar *_default_label;
+
+    // WARNING:
+    // Methods below should not be used outside of the SP tree,
+    // as they operate directly on the XML representation.
+    // In future, they will be made protected.
     void attach(SPObject *object, SPObject *prev);
     void reorder(SPObject *prev);
     void detach(SPObject *object);