From 1fec24e0fff95afaa90bbf811e9f8db659eb9324 Mon Sep 17 00:00:00 2001
From: Adam Powell <adamp@google.com>
Date: Thu, 15 Sep 2011 14:19:30 -0700
Subject: Update docs for RelativeLayout to better explain its interpretation
 of gravity.

Change-Id: Ie52dc23458c73dfb7fdbf929b802f968ef905557
---
 core/java/android/widget/RelativeLayout.java | 5 +++++
 1 file changed, 5 insertions(+)

(limited to 'core/java/android/widget/RelativeLayout.java')

diff --git a/core/java/android/widget/RelativeLayout.java b/core/java/android/widget/RelativeLayout.java
index 6edfd5923973..12a93ac888dc 100644
--- a/core/java/android/widget/RelativeLayout.java
+++ b/core/java/android/widget/RelativeLayout.java
@@ -212,6 +212,11 @@ public class RelativeLayout extends ViewGroup {
      * Describes how the child views are positioned. Defaults to
      * <code>Gravity.LEFT | Gravity.TOP</code>.
      *
+     * <p>Note that since RelativeLayout considers the positioning of each child
+     * relative to one another to be significant, setting gravity will affect
+     * the positioning of all children as a single unit within the parent.
+     * This happens after children have been relatively positioned.</p>
+     *
      * @param gravity See {@link android.view.Gravity}
      *
      * @see #setHorizontalGravity(int)
-- 
cgit v1.2.3