diff --git a/apps/openmw/mwworld/refdata.hpp b/apps/openmw/mwworld/refdata.hpp
index 642f5412c..d5701efc5 100644
--- a/apps/openmw/mwworld/refdata.hpp
+++ b/apps/openmw/mwworld/refdata.hpp
@@ -73,6 +73,11 @@ namespace MWWorld
             void setLocals (const ESM::Script& script);
 
             void setCount (int count);
+            /// Set object count (an object pile is a simple object with a count >1).
+            ///
+            /// \warning Do not call setCount() to add or remove objects from a
+            /// container or an actor's inventory. Call ContainerStore::add() or
+            /// ContainerStore::remove() instead.
 
             MWScript::Locals& getLocals();