am a7f86bf6: am be3d2cf1: am 2f8cc17f: cherrypick from ics-mr1 docs: source...

<!--

  Copyright (C) 2012 The Android Open Source Project

  Licensed under the Apache License, Version 2.0 (the "License");

  you may not use this file except in compliance with the License.

  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software

  distributed under the License is distributed on an "AS IS" BASIS,

  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  See the License for the specific language governing permissions and

  limitations under the License.

  -->

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

    package="com.example.android.networkusage"

    android:versionCode="1"

    android:versionName="1.0" >

    <uses-sdk android:minSdkVersion="4"

        android:targetSdkVersion="14" />

    <uses-permission android:name="android.permission.INTERNET" />

    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

    <application

        android:icon="@drawable/ic_launcher"

        android:label="@string/app_name" >

        <activity

            android:name="com.example.networkusage.NetworkActivity"

            android:label="@string/app_name" >

            <intent-filter>

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

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

            </intent-filter>

        </activity>

        <activity android:label="SettingsActivity" android:name=".SettingsActivity">

             <intent-filter>

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

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

          </intent-filter>

        </activity>

    </application>

</manifest>

README

======

This Network Usage sample app does the following:

-- Downloads an XML feed from StackOverflow.com for the most recent posts tagged "android".

-- Parses the XML feed, combines feed elements with HTML markup, and displays the resulting HTML in the UI.

-- Lets users control their network data usage through a settings UI. Users can choose to fetch the feed

   when any network connection is available, or only when a Wi-Fi connection is available.

-- Detects when there is a change in the device's connection status and responds accordingly. For example, if

   the device loses its network connection, the app will not attempt to download the feed.