summaryrefslogtreecommitdiffstats
path: root/core
diff options
context:
space:
mode:
authorRoboErik <epastern@google.com>2011-10-20 16:57:18 -0700
committerRoboErik <epastern@google.com>2011-10-20 17:13:29 -0700
commit8a8eebcbe8e3aded682c9c4937e155218ddf7ff4 (patch)
tree0bcb1b843bedefbb7fc5f76a8a7609e331e1d1e4 /core
parentdf1f572e0be1d3fd6cc34e1998ca5f82e0760410 (diff)
downloadframeworks_base-8a8eebcbe8e3aded682c9c4937e155218ddf7ff4.zip
frameworks_base-8a8eebcbe8e3aded682c9c4937e155218ddf7ff4.tar.gz
frameworks_base-8a8eebcbe8e3aded682c9c4937e155218ddf7ff4.tar.bz2
Color API comment updates.
Change-Id: I61c00089d0cd39e145126e709e46ba3441d49a2a
Diffstat (limited to 'core')
-rw-r--r--core/java/android/provider/CalendarContract.java16
1 files changed, 11 insertions, 5 deletions
diff --git a/core/java/android/provider/CalendarContract.java b/core/java/android/provider/CalendarContract.java
index ded496c..f71e350 100644
--- a/core/java/android/provider/CalendarContract.java
+++ b/core/java/android/provider/CalendarContract.java
@@ -304,7 +304,8 @@ public final class CalendarContract {
* or an empty string are reserved for indicating that the calendar does
* not use an index for looking up the color. The provider will update
* {@link #CALENDAR_COLOR} automatically when a valid index is written
- * to this column. @see Colors
+ * to this column. The index must reference an existing row of the
+ * {@link Colors} table. @see Colors
* <P>
* Type: TEXT
* </P>
@@ -852,8 +853,11 @@ public final class CalendarContract {
* string are reserved for indicating that the event does not use an
* index for looking up the color. The provider will update
* {@link #EVENT_COLOR} automatically when a valid index is written to
- * this column. @see Colors
- * <P>Type: TEXT</P>
+ * this column. The index must reference an existing row of the
+ * {@link Colors} table. @see Colors
+ * <P>
+ * Type: TEXT
+ * </P>
* TODO UNHIDE
*
* @hide
@@ -2329,7 +2333,7 @@ public final class CalendarContract {
/**
* The index used to reference this color. This can be any non-empty
* string, but must be unique for a given {@link #ACCOUNT_TYPE} and
- * {@link #ACCOUNT_NAME} . Column name.
+ * {@link #ACCOUNT_NAME}. Column name.
* <P>
* Type: TEXT
* </P>
@@ -2354,7 +2358,9 @@ public final class CalendarContract {
* Fields for accessing colors available for a given account. Colors are
* referenced by {@link #COLOR_INDEX} which must be unique for a given
* account name/type. These values should only be updated by the sync
- * adapter.
+ * adapter. Only {@link #COLOR} may be updated after the initial insert. In
+ * addition, a row can only be deleted once all references to that color
+ * have been removed from the {@link Calendars} or {@link Events} tables.
* TODO UNHIDE
*
* @hide