[rygel] media-export: Some more comments

[Murray Cumming <murrayc src gnome org>]

commit 164c7b4dab2597a90f5112898c3f2dfbb5e59acf
Author: Murray Cumming <murrayc murrayc com>
Date:   Mon Jan 21 11:26:26 2013 +0100

    media-export: Some more comments

 .../rygel-media-export-root-container.vala         |   11 ++++++++++-
 1 files changed, 10 insertions(+), 1 deletions(-)
---
diff --git a/src/plugins/media-export/rygel-media-export-root-container.vala b/src/plugins/media-export/rygel-media-export-root-container.vala
index e903b85..e906954 100644
--- a/src/plugins/media-export/rygel-media-export-root-container.vala
+++ b/src/plugins/media-export/rygel-media-export-root-container.vala
@@ -439,10 +439,11 @@ public class Rygel.MediaExport.RootContainer : TrackableDbContainer {
     // Signal that the container has been updated with new/changed content.
     private void root_updated () {
 
+        // Emit the "container-updated" signal
         this.updated ();
 
         // Persist the container_update_id value that was generated by
-        // the call to updated ().
+        // the call to updated().
         try {
             this.media_db.save_container (this);
         } catch (Error error) { }
@@ -459,8 +460,11 @@ public class Rygel.MediaExport.RootContainer : TrackableDbContainer {
         // also add the virtual folders:
         this.add_default_virtual_folders ();
 
+        // Signal that the container has changed:
         root_updated ();
 
+        // When the filesystem container changes,
+        // re-add the virtual folders, to update them.
         this.filesystem_container.container_updated.connect( () => {
             this.add_default_virtual_folders ();
             root_updated ();
@@ -481,6 +485,11 @@ public class Rygel.MediaExport.RootContainer : TrackableDbContainer {
         } catch (Error error) {};
     }
 
+    /**
+     * Add a QueryContainer to the provided container,
+     * for the specified UpNP class,
+     * with the specified definition.
+     */
     private void add_folder_definition (MediaContainer   container,
                                         string           item_class,
                                         FolderDefinition definition)