[Xfce4-commits] <ristretto:master> Add comments

[Stephan Arts]

Updating branch refs/heads/master
         to dce4a45dd28776e3c1ab7b5acd98c8f08a20904d (commit)
       from e4fc47673dd86cc63a9ec691ed91e0da94218188 (commit)

commit dce4a45dd28776e3c1ab7b5acd98c8f08a20904d
Author: Stephan Arts <stephan at xfce.org>
Date:   Sun Aug 7 00:36:01 2011 +0200

    Add comments

 src/image_viewer.c |   12 ++++++++++++
 1 files changed, 12 insertions(+), 0 deletions(-)

diff --git a/src/image_viewer.c b/src/image_viewer.c
index 04f7031..0108814 100644
--- a/src/image_viewer.c
+++ b/src/image_viewer.c
@@ -1777,6 +1777,11 @@ cb_rstto_image_viewer_button_release_event (RsttoImageViewer *viewer, GdkEventBu
                         viewer->priv->scale = scale;
 
                         
+                        /*
+                         * Prevent the adjustments from emitting the 'changed' signal,
+                         * this way both the upper-limit and value can be changed before the
+                         * rest of the application is informed.
+                         */
                         g_object_freeze_notify(G_OBJECT(viewer->hadjustment));
                         g_object_freeze_notify(G_OBJECT(viewer->vadjustment));
 
@@ -1785,9 +1790,16 @@ cb_rstto_image_viewer_button_release_event (RsttoImageViewer *viewer, GdkEventBu
                         gtk_adjustment_set_upper (viewer->vadjustment, (gdouble)height*(viewer->priv->scale/viewer->priv->image_scale));
                         gtk_adjustment_set_value (viewer->vadjustment, (tmp_y * scale - ((gdouble)gtk_adjustment_get_page_size(viewer->vadjustment)/2)));
 
+                        /*
+                         * Enable signals on the adjustments.
+                         */
                         g_object_thaw_notify(G_OBJECT(viewer->vadjustment));
                         g_object_thaw_notify(G_OBJECT(viewer->hadjustment));
 
+                        /*
+                         * Trigger the 'changed' signal, update the rest of
+                         * the appliaction.
+                         */
                         gtk_adjustment_changed(viewer->hadjustment);
                         gtk_adjustment_changed(viewer->vadjustment);