Remove redundant "represents" wording from most of the documentation.

[hildon] / hildon / hildon-button.c

diff --git a/hildon/hildon-button.c b/hildon/hildon-button.c
index 7123152..dd28e27 100644 (file)
--- a/hildon/hildon-button.c
+++ b/hildon/hildon-button.c
@@ -18,10 +18,10 @@
 
 /**
  * SECTION:hildon-button
- * @short_description: Widget representing a button in the Hildon framework.
+ * @short_description: Two-label buttons in the Hildon framework.
  *
- * The #HildonButton is a GTK widget which represents a clickable
- * button. It is derived from the #GtkButton widget and provides
+ * The #HildonButton is a clickable button for Hildon applications.
+ * It is derived from the #GtkButton widget and provides
  * additional commodities specific to the Hildon framework.
  *
  * The height of a #HildonButton can be set to either "finger" height
@@ -534,8 +534,8 @@ hildon_button_set_arrangement                   (HildonButton            *button
  *
  * This will clear any previously set title.
  *
- * If @title is set to %NULL, the title label will be hidden and the
- * value label will be realigned.
+ * If @title is set to %NULL or an empty string, the title label will
+ * be hidden and the value label will be realigned.
  *
  * Since: 2.2
  **/
@@ -552,7 +552,7 @@ hildon_button_set_title                         (HildonButton *button,
 
     /* If the button has no title, hide the label so the value is
      * properly aligned */
-    if (title) {
+    if (title && title[0] != '\0') {
         hildon_button_construct_child (button);
         gtk_widget_show (GTK_WIDGET (priv->title));
     } else {
@@ -571,8 +571,8 @@ hildon_button_set_title                         (HildonButton *button,
  *
  * This will clear any previously set value.
  *
- * If @value is set to %NULL, the value label will be hidden and the
- * title label will be realigned.
+ * If @value is set to %NULL or an empty string, the value label will
+ * be hidden and the title label will be realigned.
  *
  * Since: 2.2
  **/
@@ -589,7 +589,7 @@ hildon_button_set_value                         (HildonButton *button,
 
     /* If the button has no value, hide the label so the title is
      * properly aligned */
-    if (value) {
+    if (value && value[0] != '\0') {
         hildon_button_construct_child (button);
         gtk_widget_show (GTK_WIDGET (priv->value));
     } else {