some documentation

page_view_widget.c

@@ -2,7 +2,6 @@
 
 #include "page_view_widget.h"
 #include "render.h"
-#include <girara/macros.h>
 #include <girara/utils.h>
 #include <girara/settings.h>
 

page_view_widget.h

@@ -6,6 +6,8 @@
 #include <gtk/gtk.h>
 #include "document.h"
 
+/** The page view widget. The widget handles all the rendering on its own. It
+ * only has to be resized. */
 typedef struct zathura_page_view_s ZathuraPageView;
 typedef struct zathura_page_view_class_s ZathuraPageViewClass;
 
@@ -30,8 +32,20 @@ struct zathura_page_view_class_s {
 #define ZATHURA_PAGE_VIEW_GET_CLASS \
   (G_TYPE_INSTANCE_GET_CLASS ((obj), ZATHURA_TYPE_PAGE_VIEW, ZathuraPageViewclass))
 
+/** Returns the type of the page view widget.
+ * @return the type
+ */
 GType zathura_page_view_get_type(void);
+/** Create a page view widget.
+ * @param page the page to be displayed
+ * @return a page view widget
+ */
 GtkWidget* zathura_page_view_new(zathura_page_t* page);
+/** Update the widget's surface. This should only be called from the render
+ * thread.
+ * @param widget the widget
+ * @param surface the new surface
+ */
 void zathura_page_view_update_surface(ZathuraPageView* widget, cairo_surface_t* surface);
 
 #endif

render.c

@@ -161,7 +161,6 @@ render(zathura_t* zathura, zathura_page_t* page)
     return false;
   }
 
-  girara_info("rendering: %d", page->number);
   gdk_threads_enter();
 
   /* create cairo surface */