diff --git a/gtk/gtktexttag.c b/gtk/gtktexttag.c
index 7d28a8996f..9774623b89 100644
--- a/gtk/gtktexttag.c
+++ b/gtk/gtktexttag.c
@@ -485,7 +485,12 @@ gtk_text_tag_class_init (GtkTextTagClass *klass)
   /**
    * GtkTextTag:indent:
    *
-   * Amount to indent the paragraph, in pixels.
+   * Amount to indent the paragraph, in pixels. 
+   *
+   * A negative value of indent will produce a hanging indentation.
+   * That is, the first line will have the full width, and subsequent
+   * lines will be indented by the absolute value of indent.
+   *
    */
   g_object_class_install_property (object_class,
                                    PROP_INDENT,
diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c
index fe7a63b69e..271f642294 100644
--- a/gtk/gtktextview.c
+++ b/gtk/gtktextview.c
@@ -998,6 +998,11 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
    * GtkTextView:indent: (attributes org.gtk.Property.get=gtk_text_view_get_indent org.gtk.Property.set=gtk_text_view_set_indent)
    *
    * Amount to indent the paragraph, in pixels.
+   *
+   * A negative value of indent will produce a hanging indentation.
+   * That is, the first line will have the full width, and subsequent
+   * lines will be indented by the absolute value of indent.
+   * 
    */
   g_object_class_install_property (gobject_class,
                                    PROP_INDENT,