Merge "Update javadocs for DreamService." into jb-mr1-dev

 *

 * <p>Dreams should be declared in the manifest as follows:</p>

 * <pre>

 * {@code

 * <service

 * <service

 *     android:name=".MyDream"

 *     android:exported="true"

 *     android:icon="@drawable/my_icon"

 *     android:label="@string/my_dream_label" >

 *

 *     <intent-filter>

 *         <action android:name="android.intent.action.MAIN" />

 *         <category android:name="android.intent.category.DREAM" />

 *     </intent-filter>

 *     <intent-filter>

 *         <action android:name="android.service.dreams.DreamService" />

 *         <category android:name="android.intent.category.DEFAULT" />

 *     </intent-filter>

 *

 *     <!-- Point to additional information for this dream (optional) -->

 *     <meta-data

 *     <!-- Point to additional information for this dream (optional) -->

 *     <meta-data

 *         android:name="android.service.dream"

 *         android:resource="@xml/my_dream" />

 * </service>

 * }

 * </service>

 * </pre>

 * <p>If specified, additional information for the dream is defined using the

 * <code>&lt;{@link android.R.styleable#Dream dream}&gt;</code> element.  For example:</p>

 * <pre>

 * (in res/xml/my_dream.xml)

 *

 * <dream xmlns:android="http://schemas.android.com/apk/res/android"

 *     android:settingsActivity="com.example.app/.MyDreamSettingsActivity" />

 * </pre>

 */

public class DreamService extends Service implements Window.Callback {