diff --git a/src/e_view_model.h b/src/e_view_model.h
index 50858254e..6b88c8a0f 100644
--- a/src/e_view_model.h
+++ b/src/e_view_model.h
@@ -38,10 +38,21 @@ struct _E_View_Model
    int                    is_desktop;
 };
 
+/**
+ * e_view_model_set_dir - Assigns a directory to a view model
+ * @m:   The view model to set the dir for
+ * @dir: The directory
+ *
+ * Set the directory for a view_model and starts monitoring it via efsd.
+ */
 void e_view_model_set_dir(E_View_Model *m, char *dir);
+
 E_View_Model * e_view_model_new();
 void e_view_model_init();
+
 E_View_Model * e_view_model_find_by_monitor_id(int id);
+
+/* Deal with incoming file events */
 void      e_view_model_file_added(int id, char *file);
 void      e_view_model_file_deleted(int id, char *file);
 void      e_view_model_file_changed(int id, char *file);
diff --git a/src/view.h b/src/view.h
index 58471cb23..a13911a1a 100644
--- a/src/view.h
+++ b/src/view.h
@@ -219,21 +219,24 @@ void      e_view_set_background(E_View *v);
 
 /**
  * e_view_set_dir - Sets view to a given directory
- * @v     The view for which to set the directory
- * @dir   The directory to set the view to
+ * @v          The view for which to set the directory
+ * @dir        The directory to set the view to
+ * @is_desktop Inidicates wether the view is a desktop  
  *
  * This function sets a view to a directory, loading the
- * view's metadata (view window coordinates etc) from that
- * directory, it also requests monitoring of the files in
- * the directory @dir from efsd.
+ * view's metadata (view window coordinates etc). If a view_model already
+ * exists for this dir, it is reused, otherwise a new on is created.
  */
 void      e_view_set_dir(E_View *v, char *dir, int is_desktop);
 
 /**
  * e_view_populate - Draws icons for all files in view
  * @v     The view to populate
+ *
+ * Goes through the list of files in the underlying view_model and calls
+ * view_add_file for each one. This results in icons being created for each
+ * file.
  */
-
 void      e_view_populate(E_View *v);
 
 /**
@@ -241,13 +244,19 @@ void      e_view_populate(E_View *v);
  * @v:    The view to initialize
  *
  * This function initializes a created view by loading
- * all the graphics, and sets the view to a given directory
- * by calling e_view_set_dir().
+ * all the graphics and creating the evas. 
  */
 void      e_view_realize(E_View *v);
 
+/**
+ * e_view_update - Redraws a view
+ * @v:    The view to redraw
+ *
+ * If the contents of the view have changed, this function redraws it.
+ */
 void      e_view_update(E_View *v);
 
+
 void      e_view_bg_reload(E_View *v);
 void      e_view_ib_reload(E_View *v);