X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkadjustment.c;h=f8dda30c4ffbb9cc0a09a81f03abd60bd5070680;hb=feb64f40b0f50735104da0a7fdafbe480763c180;hp=29aa1c9370761a6578ac9deece126499ce24e9e7;hpb=1ff2076cdde99337752a897cfb11e7f646694237;p=~andy%2Fgtk diff --git a/gtk/gtkadjustment.c b/gtk/gtkadjustment.c index 29aa1c937..f8dda30c4 100644 --- a/gtk/gtkadjustment.c +++ b/gtk/gtkadjustment.c @@ -12,9 +12,7 @@ * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the - * Free Software Foundation, Inc., 59 Temple Place - Suite 330, - * Boston, MA 02111-1307, USA. + * License along with this library. If not, see . */ /* @@ -222,8 +220,8 @@ gtk_adjustment_class_init (GtkAdjustmentClass *class) * GtkAdjustment::changed: * @adjustment: the object which received the signal. * - * Emitted when one or more of the #GtkAdjustment fields have been changed, - * other than the value field. + * Emitted when one or more of the #GtkAdjustment properties have been + * changed, other than the #GtkAdjustment:value property. */ adjustment_signals[CHANGED] = g_signal_new (I_("changed"), @@ -238,7 +236,7 @@ gtk_adjustment_class_init (GtkAdjustmentClass *class) * GtkAdjustment::value-changed: * @adjustment: the object which received the signal. * - * Emitted when the #GtkAdjustment value field has been changed. + * Emitted when the #GtkAdjustment:value property has been changed. */ adjustment_signals[VALUE_CHANGED] = g_signal_new (I_("value-changed"), @@ -416,11 +414,11 @@ gtk_adjustment_get_value (GtkAdjustment *adjustment) * @value: the new value. * * Sets the #GtkAdjustment value. The value is clamped to lie between - * #GtkAdjustment.lower and #GtkAdjustment.upper. + * #GtkAdjustment:lower and #GtkAdjustment:upper. * * Note that for adjustments which are used in a #GtkScrollbar, the effective - * range of allowed values goes from #GtkAdjustment.lower to - * #GtkAdjustment.upper - #GtkAdjustment.page_size. + * range of allowed values goes from #GtkAdjustment:lower to + * #GtkAdjustment:upper - #GtkAdjustment:page_size. */ void gtk_adjustment_set_value (GtkAdjustment *adjustment, @@ -472,16 +470,16 @@ gtk_adjustment_get_lower (GtkAdjustment *adjustment) * Sets the minimum value of the adjustment. * * When setting multiple adjustment properties via their individual - * setters, multiple "changed" signals will be emitted. However, since - * the emission of the "changed" signal is tied to the emission of the - * "GObject::notify" signals of the changed properties, it's possible - * to compress the "changed" signals into one by calling + * setters, multiple #GtkAdjustment::changed signals will be emitted. However, since + * the emission of the #GtkAdjustment::changed signal is tied to the emission of the + * #GObject::notify signals of the changed properties, it's possible + * to compress the #GtkAdjustment::changed signals into one by calling * g_object_freeze_notify() and g_object_thaw_notify() around the * calls to the individual setters. * * Alternatively, using a single g_object_set() for all the properties * to change, or using gtk_adjustment_configure() has the same effect - * of compressing "changed" emissions. + * of compressing #GtkAdjustment::changed emissions. * * Since: 2.14 **/ @@ -525,7 +523,7 @@ gtk_adjustment_get_upper (GtkAdjustment *adjustment) * property is nonzero. * * See gtk_adjustment_set_lower() about how to compress multiple - * emissions of the "changed" signal when setting multiple adjustment + * emissions of the #GtkAdjustment::changed signal when setting multiple adjustment * properties. * * Since: 2.14 @@ -566,7 +564,7 @@ gtk_adjustment_get_step_increment (GtkAdjustment *adjustment) * Sets the step increment of the adjustment. * * See gtk_adjustment_set_lower() about how to compress multiple - * emissions of the "changed" signal when setting multiple adjustment + * emissions of the #GtkAdjustment::changed signal when setting multiple adjustment * properties. * * Since: 2.14 @@ -607,7 +605,7 @@ gtk_adjustment_get_page_increment (GtkAdjustment *adjustment) * Sets the page increment of the adjustment. * * See gtk_adjustment_set_lower() about how to compress multiple - * emissions of the "changed" signal when setting multiple adjustment + * emissions of the #GtkAdjustment::changed signal when setting multiple adjustment * properties. * * Since: 2.14 @@ -648,7 +646,7 @@ gtk_adjustment_get_page_size (GtkAdjustment *adjustment) * Sets the page size of the adjustment. * * See gtk_adjustment_set_lower() about how to compress multiple - * emissions of the "changed" signal when setting multiple adjustment + * emissions of the GtkAdjustment::changed signal when setting multiple adjustment * properties. * * Since: 2.14 @@ -675,9 +673,9 @@ gtk_adjustment_set_page_size (GtkAdjustment *adjustment, * * Sets all properties of the adjustment at once. * - * Use this function to avoid multiple emissions of the "changed" + * Use this function to avoid multiple emissions of the #GtkAdjustment::changed * signal. See gtk_adjustment_set_lower() for an alternative way - * of compressing multiple emissions of "changed" into one. + * of compressing multiple emissions of #GtkAdjustment::changed into one. * * Since: 2.14 **/ @@ -738,7 +736,7 @@ gtk_adjustment_configure (GtkAdjustment *adjustment, * * Emits a #GtkAdjustment::changed signal from the #GtkAdjustment. * This is typically called by the owner of the #GtkAdjustment after it has - * changed any of the #GtkAdjustment fields other than the value. + * changed any of the #GtkAdjustment properties other than the value. */ void gtk_adjustment_changed (GtkAdjustment *adjustment) @@ -754,7 +752,7 @@ gtk_adjustment_changed (GtkAdjustment *adjustment) * * Emits a #GtkAdjustment::value_changed signal from the #GtkAdjustment. * This is typically called by the owner of the #GtkAdjustment after it has - * changed the #GtkAdjustment value field. + * changed the #GtkAdjustment:value property. */ void gtk_adjustment_value_changed (GtkAdjustment *adjustment) @@ -771,9 +769,9 @@ gtk_adjustment_value_changed (GtkAdjustment *adjustment) * @lower: the lower value. * @upper: the upper value. * - * Updates the #GtkAdjustment #GtkAdjustment.value to ensure that the range + * Updates the #GtkAdjustment:value property to ensure that the range * between @lower and @upper is in the current page (i.e. between - * #GtkAdjustment.value and #GtkAdjustment.value + #GtkAdjustment.page_size). + * #GtkAdjustment:value and #GtkAdjustment:value + #GtkAdjustment:page_size). * If the range is larger than the page size, then only the start of it will * be in the current page. * A #GtkAdjustment::changed signal will be emitted if the value is changed.