Merge "docs: fix a bunch of links from javadocs to api guides and add some attributes to Spinner and Switch" into jb-dev

core/java/android/app/DatePickerDialog.java

@@ -33,8 +33,8 @@ import java.util.Calendar;
 /**
  * A simple dialog containing an {@link android.widget.DatePicker}.
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-datepicker.html">Date Picker
+ * <p>See the <a href="{@docRoot}guide/topics/ui/controls/pickers.html">Pickers</a>
- * tutorial</a>.</p>
+ * guide.</p>
  */
 public class DatePickerDialog extends AlertDialog implements OnClickListener,
         OnDateChangedListener {

core/java/android/app/TimePickerDialog.java

@@ -30,8 +30,8 @@ import android.widget.TimePicker.OnTimeChangedListener;
 /**
  * A dialog that prompts the user for the time of day using a {@link TimePicker}.
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-timepicker.html">Time Picker
+ * <p>See the <a href="{@docRoot}guide/topics/ui/controls/pickers.html">Pickers</a>
- * tutorial</a>.</p>
+ * guide.</p>
  */
 public class TimePickerDialog extends AlertDialog
         implements OnClickListener, OnTimeChangedListener {

core/java/android/webkit/WebView.java

@@ -65,8 +65,8 @@ import java.util.Map;
  * href="{@docRoot}guide/topics/manifest/manifest-element.html">{@code <manifest>}</a>
  * element.</p>
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-webview.html">Web View
+ * <p>For more information, read
- * tutorial</a>.</p>
+ * <a href="{@docRoot}guide/webapps/webview.html">Building Web Apps in WebView</a>.</p>
  *
  * <h3>Basic usage</h3>
  *

core/java/android/widget/AutoCompleteTextView.java

@@ -75,8 +75,8 @@ import com.android.internal.R;
  * }
  * </pre>
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-autocomplete.html">Auto Complete
+ * <p>See the <a href="{@docRoot}guide/topics/ui/controls/text.html">Text Fields</a>
- * tutorial</a>.</p>
+ * guide.</p>
  *
  * @attr ref android.R.styleable#AutoCompleteTextView_completionHint
  * @attr ref android.R.styleable#AutoCompleteTextView_completionThreshold

core/java/android/widget/Button.java

@@ -83,8 +83,8 @@ import android.widget.RemoteViews.RemoteView;
  * href="{@docRoot}guide/topics/resources/drawable-resource.html#StateList">State List
  * Drawable</a>.</p>
  *
- * <p>Also see the <a href="{@docRoot}resources/tutorials/views/hello-formstuff.html">Form Stuff
+ * <p>See the <a href="{@docRoot}guide/topics/ui/controls/button.html">Buttons</a>
- * tutorial</a> for an example implementation of a button.</p>
+ * guide.</p>
  *
  * <p><strong>XML attributes</strong></p>
  * <p>

core/java/android/widget/CheckBox.java

@@ -44,8 +44,8 @@ import android.view.accessibility.AccessibilityNodeInfo;
  * }
  * </pre>
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-formstuff.html">Form Stuff
+ * <p>See the <a href="{@docRoot}guide/topics/ui/controls/checkbox.html">Checkboxes</a>
- * tutorial</a>.</p>
+ * guide.</p>
  *  
  * <p><strong>XML attributes</strong></p> 
  * <p>

core/java/android/widget/DatePicker.java

@@ -53,8 +53,8 @@ import java.util.TimeZone;
  * displayed. Also the minimal and maximal date from which dates to be selected
  * can be customized.
  * <p>
- * See the <a href="{@docRoot}resources/tutorials/views/hello-datepicker.html">Date
+ * See the <a href="{@docRoot}guide/topics/ui/controls/pickers.html">Pickers</a>
- * Picker tutorial</a>.
+ * guide.
  * </p>
  * <p>
  * For a dialog using this view, see {@link android.app.DatePickerDialog}.

core/java/android/widget/EditText.java

@@ -38,8 +38,8 @@ import android.view.accessibility.AccessibilityNodeInfo;
  * EditText is a thin veneer over TextView that configures itself
  * to be editable.
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-formstuff.html">Form Stuff
+ * <p>See the <a href="{@docRoot}guide/topics/ui/controls/text.html">Text Fields</a>
- * tutorial</a>.</p>
+ * guide.</p>
  * <p>
  * <b>XML attributes</b>
  * <p>

core/java/android/widget/GridView.java

@@ -37,8 +37,8 @@ import android.widget.RemoteViews.RemoteView;
  * A view that shows items in two-dimensional scrolling grid. The items in the
  * grid come from the {@link ListAdapter} associated with this view.
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-gridview.html">Grid
+ * <p>See the <a href="{@docRoot}guide/topics/ui/layout/gridview.html">Grid
- * View tutorial</a>.</p>
+ * View</a> guide.</p>
  * 
  * @attr ref android.R.styleable#GridView_horizontalSpacing
  * @attr ref android.R.styleable#GridView_verticalSpacing

core/java/android/widget/ImageButton.java

@@ -64,8 +64,8 @@ import java.util.Map;
  * it will only be applied after {@code android:state_pressed} and {@code
  * android:state_focused} have both evaluated false.</p>
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-formstuff.html">Form Stuff
+ * <p>See the <a href="{@docRoot}guide/topics/ui/controls/button.html">Buttons</a>
- * tutorial</a>.</p>
+ * guide.</p>
  *
  * <p><strong>XML attributes</strong></p>
  * <p>

core/java/android/widget/LinearLayout.java

@@ -41,8 +41,8 @@ import android.widget.RemoteViews.RemoteView;
  * {@link android.widget.LinearLayout.LayoutParams LinearLayout.LayoutParams}.
  * The default orientation is horizontal.
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-linearlayout.html">Linear Layout
+ * <p>See the <a href="{@docRoot}guide/topics/ui/layout/linear.html">Linear Layout</a>
- * tutorial</a>.</p>
+ * guide.</p>
  *
  * <p>
  * Also see {@link LinearLayout.LayoutParams android.widget.LinearLayout.LayoutParams}

core/java/android/widget/ListView.java

@@ -57,8 +57,8 @@ import java.util.ArrayList;
  * A view that shows items in a vertically scrolling list. The items
  * come from the {@link ListAdapter} associated with this view.
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-listview.html">List View
+ * <p>See the <a href="{@docRoot}guide/topics/ui/layout/listview.html">List View</a>
- * tutorial</a>.</p>
+ * guide.</p>
  *
  * @attr ref android.R.styleable#ListView_entries
  * @attr ref android.R.styleable#ListView_divider

core/java/android/widget/RadioButton.java

@@ -38,8 +38,8 @@ import com.android.internal.R;
  * a radio group, checking one radio button unchecks all the others.</p>
  * </p>
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-formstuff.html">Form Stuff
+ * <p>See the <a href="{@docRoot}guide/topics/ui/controls/radiobutton.html">Radio Buttons</a>
- * tutorial</a>.</p>
+ * guide.</p>
  *
  * <p><strong>XML attributes</strong></p>
  * <p> 

core/java/android/widget/RatingBar.java

@@ -44,9 +44,6 @@ import com.android.internal.R;
  * The secondary progress should not be modified by the client as it is used
  * internally as the background for a fractionally filled star.
  * 
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-formstuff.html">Form Stuff
- * tutorial</a>.</p>
- * 
  * @attr ref android.R.styleable#RatingBar_numStars
  * @attr ref android.R.styleable#RatingBar_rating
  * @attr ref android.R.styleable#RatingBar_stepSize

core/java/android/widget/RelativeLayout.java

@@ -56,8 +56,8 @@ import static android.util.Log.d;
  * {@link #ALIGN_PARENT_BOTTOM}.
  * </p>
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-relativelayout.html">Relative
+ * <p>See the <a href="{@docRoot}guide/topics/ui/layout/relative.html">Relative
- * Layout tutorial</a>.</p>
+ * Layout</a> guide.</p>
  *
  * <p>
  * Also see {@link android.widget.RelativeLayout.LayoutParams RelativeLayout.LayoutParams} for

core/java/android/widget/Spinner.java

@@ -39,10 +39,16 @@ import android.view.accessibility.AccessibilityNodeInfo;
  * The items in the Spinner come from the {@link Adapter} associated with
  * this view.
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-spinner.html">Spinner
+ * <p>See the <a href="{@docRoot}guide/topics/ui/controls/spinner.html">Spinners</a> guide.</p>
- * tutorial</a>.</p>
  *
+ * @attr ref android.R.styleable#Spinner_dropDownHorizontalOffset
+ * @attr ref android.R.styleable#Spinner_dropDownSelector
+ * @attr ref android.R.styleable#Spinner_dropDownVerticalOffset
+ * @attr ref android.R.styleable#Spinner_dropDownWidth
+ * @attr ref android.R.styleable#Spinner_gravity
+ * @attr ref android.R.styleable#Spinner_popupBackground
  * @attr ref android.R.styleable#Spinner_prompt
+ * @attr ref android.R.styleable#Spinner_spinnerMode
  */
 @Widget
 public class Spinner extends AbsSpinner implements OnClickListener {
@@ -409,6 +415,7 @@ public class Spinner extends AbsSpinner implements OnClickListener {
     /**
      * <p>A spinner does not support item click events. Calling this method
      * will raise an exception.</p>
+     * <p>Instead use {@link AdapterView#setOnItemSelectedListener}.
      *
      * @param l this listener will be ignored
      */

core/java/android/widget/Switch.java

@@ -53,6 +53,17 @@ import com.android.internal.R;
  * {@link #setSwitchTextAppearance(android.content.Context, int) switchTextAppearance} and
  * the related seSwitchTypeface() methods control that of the thumb.
  *
+ * <p>See the <a href="{@docRoot}guide/topics/ui/controls/togglebutton.html">Toggle Buttons</a>
+ * guide.</p>
+ *
+ * @attr ref android.R.styleable#Switch_textOn
+ * @attr ref android.R.styleable#Switch_textOff
+ * @attr ref android.R.styleable#Switch_switchMinWidth
+ * @attr ref android.R.styleable#Switch_switchPadding
+ * @attr ref android.R.styleable#Switch_switchTextAppearance
+ * @attr ref android.R.styleable#Switch_thumb
+ * @attr ref android.R.styleable#Switch_thumbTextPadding
+ * @attr ref android.R.styleable#Switch_track
  */
 public class Switch extends CompoundButton {
     private static final int TOUCH_MODE_IDLE = 0;

core/java/android/widget/TimePicker.java

@@ -48,8 +48,8 @@ import java.util.Locale;
  * or 'P' to pick. For a dialog using this view, see
  * {@link android.app.TimePickerDialog}.
  *<p>
- * See the <a href="{@docRoot}resources/tutorials/views/hello-timepicker.html">Time Picker
+ * See the <a href="{@docRoot}guide/topics/ui/controls/pickers.html">Pickers</a>
- * tutorial</a>.
+ * guide.
  * </p>
  */
 @Widget

core/java/android/widget/ToggleButton.java

@@ -31,8 +31,8 @@ import com.android.internal.R;
  * Displays checked/unchecked states as a button
  * with a "light" indicator and by default accompanied with the text "ON" or "OFF".
  *
- * <p>See the <a href="{@docRoot}resources/tutorials/views/hello-formstuff.html">Form Stuff
+ * <p>See the <a href="{@docRoot}guide/topics/ui/controls/togglebutton.html">Toggle Buttons</a>
- * tutorial</a>.</p>
+ * guide.</p>
  * 
  * @attr ref android.R.styleable#ToggleButton_textOn
  * @attr ref android.R.styleable#ToggleButton_textOff