am fd516987: docs: misc bugs from external tracker

 *

 * <p>DialogFragment needs to ensure that what is happening with the Fragment

 * and Dialog states remains consistent.  To do this, it watches for dismiss

 * events from the dialog and takes are of removing its own state when they

 * events from the dialog and takes care of removing its own state when they

 * happen.  This means you should use {@link #show(FragmentManager, String)}

 * or {@link #show(FragmentTransaction, String)} to add an instance of

 * DialogFragment to your UI, as these keep track of how DialogFragment should

</p>

<pre>&lt;intent-filter . . . &gt;

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

    <category android:name="code android.intent.category.LAUNCHER" />

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

    <category android:name="android.intent.category.LAUNCHER" />

&lt;/intent-filter&gt;</pre>

<p>A dialog is usually a small window that appears in front of the current Activity.

The underlying Activity loses focus and the dialog accepts all user interaction. Dialogs are

normally used for notifications that should interupt the user and to perform short tasks that

normally used for notifications that should interrupt the user and to perform short tasks that

directly relate to the application in progress (such as a progress bar or a login prompt).</p>

<p>The {@link android.app.Dialog} class is the base class for creating dialogs. However, you

emailIntent.putExtra(Intent.EXTRA_EMAIL, new String[] {"jon@example.com"}); // recipients

emailIntent.putExtra(Intent.EXTRA_SUBJECT, "Email subject");

emailIntent.putExtra(Intent.EXTRA_TEXT, "Email message text");

emailIntent.putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment");

emailIntent.putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment"));

// You can also attach multiple items by passing an ArrayList of Uris

</pre>

  </li>