Merge branch 'readonly-p4-donut' into donut

AI 147317: am: CL 147314 change carousel SDK to 1.5;
  revise Google IO info
  Original author: smain
  Merged from: //branches/cupcake/...

Automated import of CL 147317

Merge branch 'readonly-p4-donut' into donut

AI 147313: am: CL 147311 update eclipse docs to include necessary AVD procedures and
  discuss relevant target facilities
  Original author: smain
  Merged from: //branches/cupcake/...

Automated import of CL 147313

Merge branch 'readonly-p4-donut' into donut

AI 147308: am: CL 147306 re-write the Developing in Other IDEs doc with updated information for 1.5
  Original author: smain
  Merged from: //branches/cupcake/...

Automated import of CL 147308

Merge branch 'readonly-p4-donut' into donut

AI 147303: am: CL 147297 Update Android 1.5 SDK Download, Release Notes, Version Notes, Highlights
  Please let me know if you have other "known issues", "resolved issues", or
  "highlights".
  Also, note that the installing and upgrading docs are being updated in
  a different CL, so the new version is not displayed on my staging server.
  Original author: ddougherty
  Merged from: //branches/cupcake/...

Automated import of CL 147303

Merge commit 'goog/readonly-p4-donut' into HEAD

Conflicts:
location/java/android/location/Geocoder.java

Do case-insensitive matching when determining whether something is music, an alarm sound, notification sound, etc.

Merge change 358 into donut

* changes:
  Fix issue 1745312: Various cleanups in media framework

Merge change 416 into donut

* changes:
  Remove debug messages.  modified:   core/java/android/hardware/Camera.java

Remove debug messages.
modified:   core/java/android/hardware/Camera.java

modified:   camera/libcameraservice/CameraService.cpp

Merge change 404 into donut

* changes:
  normalize the DATA_STATE_RADIO_OFF event log id definition

Merge change 403 into donut

* changes:
  remove superfluous lines

Fix timing problem that was introduced when we removed location provider polling

The wake lock was not being held until after we enabled location tracking,
so the check to see if the wake lock was held before propogating a
new location prevented us from receiving a network location as soon as we
enabled the provider.
This check is not necessary anyway, so this change removes it.

Signed-off-by: Mike Lockwood <lockwood@android.com>

normalize the DATA_STATE_RADIO_OFF event log id definition

Was this different intentionally?  It looks internal, and with very limited usage, and so easy to bring in line with the others...

remove superfluous lines

location: Remove support for a message that never actually gets sent.

Signed-off-by: Mike Lockwood <lockwood@android.com>

location: Remove unnecessary code that monitors the screen on/off state.

Signed-off-by: Mike Lockwood <lockwood@android.com>

AI 147294: am: CL 147290 Update Geocoder javadoc to reflect the need for a backend service.
  Original author: xav
  Merged from: //branches/cupcake/...

Automated import of CL 147294

Merge change 387 into donut

* changes:
  Geocoder: Document behavior when no backend service is available.

Geocoder: Document behavior when no backend service is available.

Signed-off-by: Mike Lockwood <lockwood@android.com>

gps: Check for null APN name when receiving telephony notifications.

Fixes bug b/1800584

Signed-off-by: Mike Lockwood <lockwood@android.com>

Merge branch 'readonly-p4-donut' into donut

AI 147253: am: CL 147250 Fix a nasty typo in the docs for ContentResolver.update(). No code changes.
  Original author: jham
  Merged from: //branches/cupcake/...

Automated import of CL 147253

Merge change 372 into donut

* changes:
  WifiService: Cleanup parsing of wifi scan results.

Merge branch 'readonly-p4-donut' into donut

AI 147239: am: CL 147238 Update tools index, replace activitycreator with android
  Original author: ddougherty
  Merged from: //branches/cupcake/...

Automated import of CL 147239

Merge branch 'readonly-p4-donut' into donut

AI 147230: am: CL 147228 Add API diff report to SDK docs (API Level 2 to 3)
  Original author: ddougherty
  Merged from: //branches/cupcake/...

Automated import of CL 147230

Merge branch 'readonly-p4-donut' into donut

AI 147224: am: CL 147219 update app-signing doc to include a guide to export a signed APK from ADT
  Original author: smain
  Merged from: //branches/cupcake/...

Automated import of CL 147224

Merge branch 'readonly-p4-donut' into donut

AI 147214: am: CL 147211 Update emulator doc for new usage with avds.
  Original author: ddougherty
  Merged from: //branches/cupcake/...

Automated import of CL 147214

WifiService: Cleanup parsing of wifi scan results.

Also add support for possitive RSSI values, fixing b/1786306

Signed-off-by: Mike Lockwood <lockwood@android.com>

Merge change 352 into donut

* changes:
  Remove dangling media recorder client reference when setCamera() is used.

Merge change 368 into donut

* changes:
  location: Add some null pointer checks.

location: Add some null pointer checks.

Signed-off-by: Mike Lockwood <lockwood@android.com>

Merge branch 'readonly-p4-donut' into donut

AI 147168: am: CL 147163 Copy documentation for the various search-by-voice flags that
  were already listed in attrs.xml into SearchManager.java.  Add
  a (brief - no time for more) description about how to add search
  by voice to apps.
  JAVADOC ONLY - should be safe change for cupcake sdk.
  Original author: stadler
  Merged from: //branches/cupcake/...

Automated import of CL 147168

Merge branch 'readonly-p4-donut' into donut

AI 147167: am: CL 147162 Emphasize in the javadoc that the "pkg" parameters to
  InstrumentationTestCase and its descendants should be the
  package manager package name (not the java package name, and
  not the test package) of the package holding the Activity
  under test.
  Added similar notations to the ApiDemos call sites.
  JAVADOC ONLY - should be safe change for cupcake sdk.
  Original author: stadler
  Merged from: //branches/cupcake/...

Automated import of CL 147167

Merge change 360 into donut

* changes:
  location: Location Manager wakelock cleanup, phase 1

location: Location Manager wakelock cleanup, phase 1

Move cell and wifi lock from LocationManagerService to NetworkLocationProvider

Signed-off-by: Mike Lockwood <lockwood@android.com>

Merge change 336 into donut

* changes:
  Ensure ongoing progress updates after using the scroll ball to adjust position.

Fix issue 1745312: Various cleanups in media framework

AudioTrack, AudioRecord:
  - remove useless mAudioFlinger member of AudioTrack and AudioRecord.
  - signal cblk.cv condition in stop() method to speed up stop completion.
  - extend wait condition timeout in obtainBuffer() when waitCount is -1 to avoid waking up callback thread unnecessarily

AudioFlinger:
  - remove some warnings in AudioFlinger.cpp.
  - remove function AudioFlinger::MixerThread::removetrack_l()  as its content is never executed.
  - remove useless call to setMasterVolume in AudioFlinger::handleForcedSpeakerRoute().
  - Offset VOICE_CALL stream volume to reflect actual volume that is never 0 in hardware (this fix has been made in the open source): 0.01 + v * 0.99.

AudioSystem.java:
  - correct typo in comment

IAudioflinger, IAudioFlingerClient:
  - make AudioFlinger binder interfaces used for callbacks ONEWAY.

AudioHardwareInterface:
  - correct routeStrings[] table in AudioHardwareInteface.cpp

Merge branch 'readonly-p4-donut' into donut

AI 147083: am: CL 147081 Add document describing AVDs and usage. (doc change only)
  Original author: ddougherty
  Merged from: //branches/cupcake/...

Automated import of CL 147083

Merge branch 'readonly-p4-donut' into donut

AI 147054: am: CL 147053 Add -hdf primer vars for the platform and release ID associated with the current (most recent) SDK.
  Currently, the docs that are specific to each SDK release -- downloading, installing, upgrading, requirements -- are stored in a directory with release-derived name, such as "1.1_r1". This change lets documents use generic links to point into the most recent version specific docs, eg href="{@docRoot}sdk/{sdkCurrent}/installing.html" instead of href="{@docRoot}sdk/1.1_r1/installing.html".
  Original author: ddougherty
  Merged from: //branches/cupcake/...

Automated import of CL 147054

Remove dangling media recorder client reference when setCamera() is used.

Ensure ongoing progress updates after using the scroll ball to adjust position.

We use a single outstanding message of type SHOW_PROGRESS to refresh the progress
bar's current position as well as textual display of time and duration. This message
could get lost if the scroll ball was used to adjust the current playback position as
we entered state "mDragging" which would cause the subsequent SHOW_PROGRESS message
to be a no-op and would also cause it to not be re-enqueued.
The change refactors the seekbar logic a little and makes sure that while dragging
there isn't a pending SHOW_PROGRESS message in the queue and once dragging is over,
exactly one SHOW_PROGRESS message is reenqueued.

related to bug 1721227

Merge branch 'readonly-p4-donut' into donut

AI 147035: am: CL 147032 Finalize JetPlayer javadoc.
  Original author: jmtrivi
  Merged from: //branches/cupcake/...

Automated import of CL 147035

Merge branch 'readonly-p4-donut' into donut

AI 146938: am: CL 146937 Finalize AudioRecord javadoc.
  Original author: jmtrivi
  Merged from: //branches/cupcake/...

Automated import of CL 146938

Merge branch 'readonly-p4-donut' into donut

AI 146934: Make TI Wifi driver choice framework-independent - part 1
  BUG=1786365

Automated import of CL 146934

Merge branch 'readonly-p4-donut' into donut

AI 146853: Add kernel wakelock data to batteryinfo dump.
  BUG=1755458

Automated import of CL 146853

Merge change 287 into donut

* changes:
  Get Sketch compiling.

Get Sketch compiling.

Add an Android.mk.
Android compiles with Java5, which doesn't let you put @Override on
interface methods.

More Location Manager cleanup:

Move LocationCollector support out of GpsLocationProvider.
Don't disable GPS when screen is off.

Signed-off-by: Mike Lockwood <lockwood@android.com>

Merge change 279 into donut

* changes:
  Add sketch gesture demo application.

Add sketch gesture demo application.

Initial checkin, there's no Android.mk yet.

Merge change 263 into donut

* changes:
  location: Generalize support for location provider usage tracking.

location: Generalize support for location provider usage tracking.

This replaces two different mechanisms that were used for GPS and Netork
location provider tracking.
Move BatteryStats logging of GPS usage from LocationManagerService to
GpsLocationProvider.
Clean up tracking of location listeners in LocationManagerService and remove
some HashMaps that are no longer needed.

Signed-off-by: Mike Lockwood <lockwood@android.com>

Merge branch 'readonly-p4-donut' into donut

AI 146755: am: CL 146754 Fix some problems in the SoundPool docs and add additional text.
  Original author: davidsparks
  Merged from: //branches/cupcake/...

Automated import of CL 146755

Merge branch 'readonly-p4-donut' into donut

AI 146752: am: CL 146751 Finalize AudioTrack javadoc.
  Original author: jmtrivi
  Merged from: //branches/cupcake/...

Automated import of CL 146752

Merge branch 'readonly-p4-donut' into donut

AI 146743: am: CL 146711 Enhancing the test runner. Now it filters BrokenTests and only executes tests
  annotated with SideEffect if the host is running in single test mode.
  Also adding some cleanup mechanism and some logcat logging about memory consumption
  Original author: ursg
  Merged from: //branches/cupcake/...

Automated import of CL 146743

Merge branch 'readonly-p4-donut' into donut

AI 146668: am: CL 146667 Add advice in MediaRecorder Java docs about using MPEG-4 container format
  Original author: davidsparks
  Merged from: //branches/cupcake/...

Automated import of CL 146668

Merge change 233 into donut

* changes:
  Add an Android-specific static OpenGL ES 1.1 Java API.

Merge branch 'readonly-p4-donut' into donut

AI 146655: am: CL 146654 Add java docs for SoundPool
  Original author: davidsparks
  Merged from: //branches/cupcake/...

Automated import of CL 146655

Add an Android-specific static OpenGL ES 1.1 Java API.

This change adds four new public classes that expose a static OpenGL ES 1.1 API:

android.opengl.GLES10
android.opengl.GLES10Ext
android.opengl.GLES11
android.opengl.GLES11Ext

Benefits:

 + The static API is slightly faster (1% to 4%) than the existing Interface based JSR239 API.
 + The static API is similar to the C API, which should make it easier to import C-based
   example code.
 + The static API provides a clear path for adding new OpenGL ES 1.1 extensions
   and OpenGL ES 2.0 APIs, neither of which currently have a JSR standard.

Example:

  import static android.opengl.GLES10.*;

  ...

  glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);

Note that it is possible to mix-and-match calls to both the static and JSR239 APIs.
This works because neither API maintains state. They both call through to the same underlying
C OpenGL ES APIs.

Implementation details:

This change enhances the "glgen" "gen" script to generate both the original JSR239 and
new static OpenGL ES APIs. The contents of the generated JSR239 classes remained the same as before,
so there is no need to check in new versions of the generated JSR239 classes.

As part of this work the gen script was updated to be somewhat more robust, and to
work with git instead of perforce. The script prints out commands to git add the generated files,
but leaves it up to the script runner to actually execute those commands.

Merge branch 'readonly-p4-donut' into donut

AI 146613: Move Recognition service declarations to frameworks/base/core/java/android/speech. Hide them from public API by default (no changes to current.xml).

Automated import of CL 146613

Merge branch 'readonly-p4-donut' into donut

AI 146610: am: CL 146609 updates to the manifest docs for cupcake: Add "since" notations for elements and some attributes.
  Original author: ddougherty
  Merged from: //branches/cupcake/...

Automated import of CL 146610

Merge branch 'readonly-p4-donut' into donut

AI 146602: am: CL 146601 Update media formats appendix for cupcake
  Original author: ddougherty
  Merged from: //branches/cupcake/...

Automated import of CL 146602

Merge branch 'readonly-p4-donut' into donut

AI 146485: am: CL 146411 Fix BridgeCanvas#drawRoundRect
  Original author: xav
  Merged from: //branches/cupcake/...

Automated import of CL 146485

Merge change 187 into donut

* changes:
  replaced integer * and % with shift operations, for performance

replaced integer * and % with shift operations, for performance

Merge change 186 into donut

* changes:
  eliminate seemingly pointless conversion to and then from hex string

Merge branch 'readonly-p4-donut' into donut

AI 146345: am: CL 146341 g4 integrate -t -i -b platform-1_0-to-cupcake @146018,146018 (doc change)
  Original author: ddougherty
  Merged from: //branches/cupcake/...

Automated import of CL 146345

Merge branch 'readonly-p4-donut' into donut

AI 146343: am: CL 146340 Integrate updated SDK Terms and Conditions document
  Original author: ddougherty
  Merged from: //branches/cupcake/...

Automated import of CL 146343

Merge change 190 into donut

* changes:
  location: Move geocoding support from ILocationProvider to a new interface.

location: Move geocoding support from ILocationProvider to a new interface.

Signed-off-by: Mike Lockwood <lockwood@android.com>

Merge change 174 into donut

* changes:
  Improve glgen

eliminate seemingly pointless conversion to and then from hex string

Merge change 175 into donut

* changes:
  telephony: Don't disable an APN type that is not enabled.