Adding some docs

diff --git a/src/sp-object.cpp b/src/sp-object.cpp
index 72a93ec3b488db362cdd5630749d1a1d782f56d6..9294a2e9f442c9f83f6f9bbc1f2c49587139b56c 100644 (file)
--- a/src/sp-object.cpp
+++ b/src/sp-object.cpp
@@ -1198,6 +1198,9 @@ SPObject::requestDisplayUpdate(unsigned int flags)
     }
 }
 
+/**
+ * Update views
+ */
 void
 SPObject::updateDisplay(SPCtx *ctx, unsigned int flags)
 {
@@ -1268,7 +1271,10 @@ SPObject::requestModified(unsigned int flags)
 }
 
 /** 
- * This is what actually delivers the modified signals
+ *  Emits the MODIFIED signal with the object's flags.
+ *  The object's mflags are the original set aside during the update pass for 
+ *  later delivery here.  Once emitModified() is called, those flags don't
+ *  need to be stored any longer.
  */
 void
 SPObject::emitModified(unsigned int flags)