[gtk+] docs: Improve reference crossing in GtkWidget docs
- From: Javier Jardón <jjardon src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+] docs: Improve reference crossing in GtkWidget docs
- Date: Mon, 11 Oct 2010 03:04:58 +0000 (UTC)
commit cabc386252f9738c0b5b9b2b98cc05da9390b141
Author: Javier Jardón <jjardon gnome org>
Date: Mon Oct 11 04:59:19 2010 +0200
docs: Improve reference crossing in GtkWidget docs
gtk/gtkwidget.c | 10 ++++++----
1 files changed, 6 insertions(+), 4 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index dc3c1a3..4ca6c4e 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -113,15 +113,16 @@
*
* A widget that does not actually do height-for-width
* or width-for-height size negotiations only has to implement
- * get_preferred_width() and get_preferred_height().
+ * #GtkWidgetClass.get_preferred_width() and
+ * #GtkWidgetClass.get_preferred_height().
*
* If a widget does move content around to smartly use up the
* allocated size, then it must support the request properly in
* both orientations; even if the request only makes sense in
* one orientation.
*
- * For instance, a GtkLabel that does height-for-width word wrapping
- * will not expect to have get_preferred_height() called because that
+ * For instance, a #GtkLabel that does height-for-width word wrapping
+ * will not expect to have #GtkWidgetClass.get_preferred_height() called because that
* call is specific to a width-for-height request. In this case the
* label must return the heights contextual to its minimum possible
* width. By following this rule any widget that handles height-for-width
@@ -143,7 +144,7 @@
* It will not work to use the wrapper functions, such as
* gtk_widget_get_preferred_width(), inside your own size request
* implementation. These return a request adjusted by #GtkSizeGroup
- * and by the GtkWidgetClass::adjust_size_request virtual method. If a
+ * and by the #GtkWidgetClass.adjust_size_request() virtual method. If a
* widget used the wrappers inside its virtual method implementations,
* then the adjustments (such as widget margins) would be applied
* twice. GTK+ therefore does not allow this and will warn if you try
@@ -157,6 +158,7 @@
* </para>
* </refsect2>
* <refsect2 id="style-properties">
+ * <title>Style Properties</title>
* <para>
* <structname>GtkWidget</structname> introduces <firstterm>style
* properties</firstterm> - these are basically object properties that are stored
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]