diff --git a/core/java/android/app/AlertDialog.java b/core/java/android/app/AlertDialog.java index c09e87fc0f9a3..e37b3faae054c 100644 --- a/core/java/android/app/AlertDialog.java +++ b/core/java/android/app/AlertDialog.java @@ -54,6 +54,12 @@ import android.widget.ListView; * without text editors, so that it will be placed on top of the current * input method UI. You can modify this behavior by forcing the flag to your * desired mode after calling {@link #onCreate}. + * + *
+ *

Developer Guides

+ *

For more information about creating dialogs, read the + * Dialogs developer guide.

+ *
*/ public class AlertDialog extends Dialog implements DialogInterface { private AlertController mAlert; diff --git a/core/java/android/app/Dialog.java b/core/java/android/app/Dialog.java index 82186dd36d406..7a6941924f030 100644 --- a/core/java/android/app/Dialog.java +++ b/core/java/android/app/Dialog.java @@ -66,9 +66,14 @@ import java.lang.ref.WeakReference; * your Dialog takes input focus, as it the default) with the following code: * *
- *     getWindow().setFlags(WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM,
- *             WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM);
- * 
+ * getWindow().setFlags(WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM, + * WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM); + * + *
+ *

Developer Guides

+ *

For more information about creating dialogs, read the + * Dialogs developer guide.

+ *
*/ public class Dialog implements DialogInterface, Window.Callback, KeyEvent.Callback, OnCreateContextMenuListener { diff --git a/core/java/android/app/Notification.java b/core/java/android/app/Notification.java index 9490b96b4f8d1..f5add25162c41 100644 --- a/core/java/android/app/Notification.java +++ b/core/java/android/app/Notification.java @@ -38,9 +38,12 @@ import java.text.NumberFormat; *

The {@link Notification.Builder Notification.Builder} has been added to make it * easier to construct Notifications.

* - *

For a guide to creating notifications, see the - * Creating Status - * Bar Notifications document in the Dev Guide.

+ *
+ *

Developer Guides

+ *

For a guide to creating notifications, read the + * Status Bar Notifications + * developer guide.

+ *
*/ public class Notification implements Parcelable { diff --git a/core/java/android/app/NotificationManager.java b/core/java/android/app/NotificationManager.java index 4913e7895fe9d..bf83f5edc1bcb 100644 --- a/core/java/android/app/NotificationManager.java +++ b/core/java/android/app/NotificationManager.java @@ -55,6 +55,13 @@ import android.util.Log; * You do not instantiate this class directly; instead, retrieve it through * {@link android.content.Context#getSystemService}. * + *
+ *

Developer Guides

+ *

For a guide to creating notifications, read the + * Status Bar Notifications + * developer guide.

+ *
+ * * @see android.app.Notification * @see android.content.Context#getSystemService */ diff --git a/core/java/android/content/ContentProvider.java b/core/java/android/content/ContentProvider.java index e452f1fa31628..092a0c854f72a 100644 --- a/core/java/android/content/ContentProvider.java +++ b/core/java/android/content/ContentProvider.java @@ -45,9 +45,6 @@ import java.util.ArrayList; * multiple applications you can use a database directly via * {@link android.database.sqlite.SQLiteDatabase}. * - *

For more information, read Content - * Providers.

- * *

When a request is made via * a {@link ContentResolver} the system inspects the authority of the given URI and passes the * request to the content provider registered with the authority. The content provider can interpret @@ -73,6 +70,12 @@ import java.util.ArrayList; *

Requests to {@link ContentResolver} are automatically forwarded to the appropriate * ContentProvider instance, so subclasses don't have to worry about the details of * cross-process calls.

+ * + *
+ *

Developer Guides

+ *

For more information about using content providers, read the + * Content Providers + * developer guide.

*/ public abstract class ContentProvider implements ComponentCallbacks2 { private static final String TAG = "ContentProvider"; diff --git a/core/java/android/content/ContentResolver.java b/core/java/android/content/ContentResolver.java index 0d25926265fc0..e923349098477 100644 --- a/core/java/android/content/ContentResolver.java +++ b/core/java/android/content/ContentResolver.java @@ -54,6 +54,12 @@ import java.util.Random; /** * This class provides applications access to the content model. + * + *
+ *

Developer Guides

+ *

For more information about using a ContentResolver with content providers, read the + * Content Providers + * developer guide.

*/ public abstract class ContentResolver { /** diff --git a/core/java/android/view/ContextMenu.java b/core/java/android/view/ContextMenu.java index dd1d7db0e7a08..decabcbcc54c8 100644 --- a/core/java/android/view/ContextMenu.java +++ b/core/java/android/view/ContextMenu.java @@ -29,6 +29,12 @@ import android.widget.AdapterView; * To show a context menu on long click, most clients will want to call * {@link Activity#registerForContextMenu} and override * {@link Activity#onCreateContextMenu}. + * + *
+ *

Developer Guides

+ *

For information about creating menus, read the + * Menus developer guide.

+ *
*/ public interface ContextMenu extends Menu { /** diff --git a/core/java/android/view/DragEvent.java b/core/java/android/view/DragEvent.java index 8f491ef61a0ff..f559e21f661e5 100644 --- a/core/java/android/view/DragEvent.java +++ b/core/java/android/view/DragEvent.java @@ -114,6 +114,12 @@ import android.os.Parcelable; * {@link android.view.DragEvent#writeToParcel(Parcel,int)}, and * {@link android.view.DragEvent#toString()} methods always return valid data. *

+ * + *
+ *

Developer Guides

+ *

For a guide to implementing drag and drop features, read the + * Drag and Drop developer guide.

+ *
*/ public class DragEvent implements Parcelable { private static final boolean TRACK_RECYCLED_LOCATION = false; diff --git a/core/java/android/view/Menu.java b/core/java/android/view/Menu.java index 97825e678a749..7157bc54a33f0 100644 --- a/core/java/android/view/Menu.java +++ b/core/java/android/view/Menu.java @@ -41,6 +41,12 @@ import android.content.Intent; * item check marks are discouraged. *
  • Sub menus: Do not support item icons, or nested sub menus. * + * + *
    + *

    Developer Guides

    + *

    For more information about creating menus, read the + * Menus developer guide.

    + *
    */ public interface Menu { diff --git a/core/java/android/view/MenuItem.java b/core/java/android/view/MenuItem.java index ccd835378ffb1..2dfbcb5c10fd1 100644 --- a/core/java/android/view/MenuItem.java +++ b/core/java/android/view/MenuItem.java @@ -29,6 +29,12 @@ import android.view.View.OnCreateContextMenuListener; * methods. *

    * For a feature set of specific menu types, see {@link Menu}. + * + *

    + *

    Developer Guides

    + *

    For information about creating menus, read the + * Menus developer guide.

    + *
    */ public interface MenuItem { /* diff --git a/core/java/android/view/SubMenu.java b/core/java/android/view/SubMenu.java index e98148616819f..196a183c58399 100644 --- a/core/java/android/view/SubMenu.java +++ b/core/java/android/view/SubMenu.java @@ -22,6 +22,12 @@ import android.graphics.drawable.Drawable; * Subclass of {@link Menu} for sub menus. *

    * Sub menus do not support item icons, or nested sub menus. + * + *

    + *

    Developer Guides

    + *

    For information about creating menus, read the + * Menus developer guide.

    + *
    */ public interface SubMenu extends Menu { diff --git a/core/java/android/view/View.java b/core/java/android/view/View.java index 73e5026df6f5b..d5f18cc2f58a5 100644 --- a/core/java/android/view/View.java +++ b/core/java/android/view/View.java @@ -418,7 +418,7 @@ import java.util.concurrent.CopyOnWriteArrayList; *

    Drawing

    *

    * Drawing is handled by walking the tree and rendering each view that - * intersects the the invalid region. Because the tree is traversed in-order, + * intersects the invalid region. Because the tree is traversed in-order, * this means that parents will draw before (i.e., behind) their children, with * siblings drawn in the order they appear in the tree. * If you set a background drawable for a View, then the View will draw it for you @@ -8364,7 +8364,7 @@ public class View implements Drawable.Callback, Drawable.Callback2, KeyEvent.Cal !((ViewGroup) mParent).isViewTransitioning(this)); } /** - * Mark the the area defined by dirty as needing to be drawn. If the view is + * Mark the area defined by dirty as needing to be drawn. If the view is * visible, {@link #onDraw(android.graphics.Canvas)} will be called at some point * in the future. This must be called from a UI thread. To call from a non-UI * thread, call {@link #postInvalidate()}. @@ -8409,7 +8409,7 @@ public class View implements Drawable.Callback, Drawable.Callback2, KeyEvent.Cal } /** - * Mark the the area defined by the rect (l,t,r,b) as needing to be drawn. + * Mark the area defined by the rect (l,t,r,b) as needing to be drawn. * The coordinates of the dirty rect are relative to the view. * If the view is visible, {@link #onDraw(android.graphics.Canvas)} * will be called at some point in the future. This must be called from @@ -13095,6 +13095,12 @@ public class View implements Drawable.Callback, Drawable.Callback2, KeyEvent.Cal * {@link android.graphics.Canvas} object, then it calls {@link #onDrawShadow(Canvas) onDrawShadow()} * so that your application can draw the shadow image in the Canvas. *

    + * + *
    + *

    Developer Guides

    + *

    For a guide to implementing drag and drop features, read the + * Drag and Drop developer guide.

    + *
    */ public static class DragShadowBuilder { private final WeakReference mView; @@ -14086,6 +14092,12 @@ public class View implements Drawable.Callback, Drawable.Callback2, KeyEvent.Cal * to this view. The callback will be invoked before the hosting view's own * onDrag(event) method. If the listener wants to fall back to the hosting view's * onDrag(event) behavior, it should return 'false' from this callback. + * + *
    + *

    Developer Guides

    + *

    For a guide to implementing drag and drop features, read the + * Drag and Drop developer guide.

    + *
    */ public interface OnDragListener { /** diff --git a/core/java/android/view/ViewGroup.java b/core/java/android/view/ViewGroup.java index 9266ae25bcdd4..62b20b3196ed8 100644 --- a/core/java/android/view/ViewGroup.java +++ b/core/java/android/view/ViewGroup.java @@ -60,6 +60,12 @@ import java.util.HashSet; * Also see {@link LayoutParams} for layout attributes. *

    * + *
    + *

    Developer Guides

    + *

    For more information about creating user interface layouts, read the + * XML Layouts developer + * guide.

    + * * @attr ref android.R.styleable#ViewGroup_clipChildren * @attr ref android.R.styleable#ViewGroup_clipToPadding * @attr ref android.R.styleable#ViewGroup_layoutAnimation @@ -5158,7 +5164,13 @@ public abstract class ViewGroup extends View implements ViewParent, ViewManager * * There are subclasses of LayoutParams for different subclasses of * ViewGroup. For example, AbsoluteLayout has its own subclass of - * LayoutParams which adds an X and Y value. + * LayoutParams which adds an X and Y value.

    + * + *
    + *

    Developer Guides

    + *

    For more information about creating user interface layouts, read the + * XML Layouts developer + * guide.

    * * @attr ref android.R.styleable#ViewGroup_Layout_layout_height * @attr ref android.R.styleable#ViewGroup_Layout_layout_width diff --git a/core/java/android/widget/Toast.java b/core/java/android/widget/Toast.java index bb23173ae0034..88d7e05dd1b36 100644 --- a/core/java/android/widget/Toast.java +++ b/core/java/android/widget/Toast.java @@ -48,6 +48,13 @@ import android.view.accessibility.AccessibilityManager; *

    * The easiest way to use this class is to call one of the static methods that constructs * everything you need and returns a new Toast object. + * + *

    + *

    Developer Guides

    + *

    For information about creating Toast notifications, read the + * Toast Notifications developer + * guide.

    + *
    */ public class Toast { static final String TAG = "Toast";