Docs: Changes to source.android.com

  - 195001558 Remove ccache reference. by Android Partner Docs <noreply@android.com>
  - 194952229 Devsite localized content from translation request c764f4... by Android Partner Docs <noreply@android.com>
  - 194945831 Updated CVE-2017-15852 from CR 2046770 to CR 2028702 by Android Partner Docs <noreply@android.com>
  - 194868341 Update _translation ignore paths by Danielle Roberts <daroberts@google.com>
  - 194851174 Add Nancy to OWNERS files by Clay Murphy <claym@google.com>
  - 194661854 Devsite localized content from translation request 4b822a... by Android Partner Docs <noreply@android.com>
  - 194661853 Devsite localized content from translation request c74c02... by Android Partner Docs <noreply@android.com>
  - 194618554 Devsite localized content from translation request bdadcc... by Android Partner Docs <noreply@android.com>
  - 194618547 Devsite localized content from translation request 8dea9d... by Android Partner Docs <noreply@android.com>
  - 194488631 Decapitalize "makefile". by Android Partner Docs <noreply@android.com>
  - 193950593 hikey: Add /vendor partition processing and fix HW manual... by Android Partner Docs <noreply@android.com>
  - 193934857 Devsite localized content from translation request e6ce03... by Android Partner Docs <noreply@android.com>
  - 193689720 Devsite localized content from translation request f27fac... by Android Partner Docs <noreply@android.com>
  - 193689713 Devsite localized content from translation request e1b66e... by Android Partner Docs <noreply@android.com>
  - 193593753 Modify arrow in graphics pipeline image by Kenneth Lau <kennethlau@google.com>
  - 193437753 Add missing arrow to graphics pipeline image by Kenneth Lau <kennethlau@google.com>
  - 193387516 Devsite localized content from translation request 787b24... by Android Partner Docs <noreply@android.com>
  - 193387506 Devsite localized content from translation request 2a66e8... by Android Partner Docs <noreply@android.com>
  - 193382083 Devsite localized content from translation request 526313... by Android Partner Docs <noreply@android.com>
  - 193381971 Add a missing closing paragraph tag and made indentation ... by Christina Nguyen <cqn@google.com>
  - 193262850 Fix typo in example adb command by Kenneth Lau <kennethlau@google.com>
  - 193228804 Devsite localized content from translation request 39ed40... by Android Partner Docs <noreply@android.com>
  - 193228719 Devsite localized content from translation request 302ea6... by Android Partner Docs <noreply@android.com>
  - 193228589 Devsite localized content from translation request 8adf7a... by Android Partner Docs <noreply@android.com>
  - 193228559 Devsite localized content from translation request c4d49a... by Android Partner Docs <noreply@android.com>
  - 193228348 Devsite localized content from translation request 745b3a... by Android Partner Docs <noreply@android.com>
  - 193228329 Devsite localized content from translation request 25491c... by Android Partner Docs <noreply@android.com>
  - 193228315 Devsite localized content from translation request cce5ca... by Android Partner Docs <noreply@android.com>
  - 193228166 Devsite localized content from translation request a40889... by Android Partner Docs <noreply@android.com>
  - 193228150 Devsite localized content from translation request 7f7709... by Android Partner Docs <noreply@android.com>
  - 193228131 Devsite localized content from translation request df8d21... by Android Partner Docs <noreply@android.com>
  - 193228083 Fix indentation issue by Kenneth Lau <kennethlau@google.com>
  - 193069808 VINTF docs: compatiblity -> compatibility by Android Partner Docs <noreply@android.com>
  - 192848037 Update VINTF SAC docs for P by Android Partner Docs <noreply@android.com>
  - 192786114 Fix typos in setup/start by Kenneth Lau <kennethlau@google.com>
  - 192662677 Reinforce 80 character limit rule by Kenneth Lau <kennethlau@google.com>
  - 192544209 Update note about setting API level flag in CTS setup dur... by Christina Nguyen <cqn@google.com>
  - 192503158 Make colons in note callout bold by Kenneth Lau <kennethlau@google.com>
  - 192502996 Fix HTML formatting by Kenneth Lau <kennethlau@google.com>
  - 192472755 Devsite localized content from translation request b2bbce... by Android Partner Docs <noreply@android.com>
  - 192472735 Devsite localized content from translation request 163e71... by Android Partner Docs <noreply@android.com>
  - 192463633 Modify Wrong Java version section by Kenneth Lau <kennethlau@google.com>
  - 192463056 Removing Jack from Bug Report queues, per cl/192346442 by Christina Nguyen <cqn@google.com>
  - 192455847 [SAC Bug] Update CTS/CTS-Verifier downloads for CTS-April... by Android Partner Docs <noreply@android.com>
  - 192375236 Replace quotation marks with bold by Kenneth Lau <kennethlau@google.com>
  - 192346442 Make it clearer that Jack is dead. by Android Partner Docs <noreply@android.com>
  - 192341401 Publishing BLE content page by Christina Nguyen <cqn@google.com>
  - 192340129 Clean up HTML by Kenneth Lau <kennethlau@google.com>
  - 192318618 Update description for A-72871435 by Danielle Roberts <daroberts@google.com>
  - 192305416 Add another pointer to asan, since it's what we recommend. by Android Partner Docs <noreply@android.com>
  - 192287879 Warn developers away from valgrind more strongly. by Android Partner Docs <noreply@android.com>
  - 192221390 Updated CVE-2017-13287 and corrected small typos by Danielle Roberts <daroberts@google.com>
  - 192209509 Mention that we also (mainly!) use Debian testing interna... by Android Partner Docs <noreply@android.com>
  - 192203111 Add a hair space around / by Danielle Roberts <daroberts@google.com>

PiperOrigin-RevId: 195001558
Change-Id: I724f862d952d0d075dfd36e8c7c677ef319abfe2

8 files changed, 173 insertions, 11 deletions

diff --git a/en/devices/_toc-interfaces.yaml b/en/devices/_toc-interfaces.yaml
index dba14fbe..504b9b72 100644
--- a/en/devices/_toc-interfaces.yaml
+++ b/en/devices/_toc-interfaces.yaml
@@ -215,6 +215,8 @@ toc:
     path: /devices/bluetooth
   - title: Services
     path: /devices/bluetooth/services
+  - title: Bluetooth Low Energy
+    path: /devices/bluetooth/ble
   - title: BLE Advertising
     path: /devices/bluetooth/ble_advertising
   - title: Verifying and Debugging
diff --git a/en/devices/architecture/vintf/comp-matrices.html b/en/devices/architecture/vintf/comp-matrices.html
index d3512e70..74589eef 100644
--- a/en/devices/architecture/vintf/comp-matrices.html
+++ b/en/devices/architecture/vintf/comp-matrices.html
@@ -22,7 +22,7 @@
   -->
 
 <p>This section describes the framework and device compatibility matrices and
-the <a href="#compatiblity-matrix-schema">compatibility matrix schema</a>. For
+the <a href="#compatibility-matrix-schema">compatibility matrix schema</a>. For
 match rules, see <a href="/devices/architecture/vintf/match-rules.html">Matching
 Rules</a>.</p>
 
@@ -102,7 +102,7 @@ device manifest (requirements enforced at launch and OTA time).</p>
         &lt;version>1.0&lt;/version>
         &lt;path>/system/etc/media_profile_V1_0.dtd&lt;/path>
     &lt;/xmlfile>
-&lt;/compatiblity-matrix>
+&lt;/compatibility-matrix>
 </pre>
 
 <h2 id="device-compatibility-matrix">Device compatibility matrix</h2>
@@ -154,12 +154,12 @@ expects from the framework (requirements enforced at launch and OTA time).
 &lt;/compatibility-matrix>
 </pre>
 
-<h2 id="compatiblity-matrix-schema">Compatiblity matrix schema</h2>
+<h2 id="compatibility-matrix-schema">Compatibility matrix schema</h2>
 <dl>
 <dt><code>?xml</code></dt>
 <dd>Optional. It only provides information to the XML parser.</dd>
 <dt><code>compatibility-matrix.version</code></dt>
-<dd>Required. Version of this compatiblity matrix. Describes the elements
+<dd>Required. Version of this compatibility matrix. Describes the elements
 expected in the manifest. Unrelated to XML version.</dd>
 <dt><code>compatibility-matrix.type</code></dt>
 <dd>Required. Type of this compatibility matrix:
@@ -202,7 +202,7 @@ device) expects.</dd>
 <dd>Optional, can repeat. A list of required interfaces of this HAL.</dd>
 <dt><code>compatibility-matrix.hal.interface.name</code></dt>
 <dd>Required. Name of the interface.</dd>
-<dt><code>compatibility-matrix.hal.interface</code></dt>
+<dt><code>compatibility-matrix.hal.interface.instance</code></dt>
 <dd>Optional, can repeat. A list of required instances of this interface.</dd>
 <dt><code>compatibility-matrix.kernel.version</code></dt>
 <dd>Required. Kernel version. Format is
diff --git a/en/devices/bluetooth/ble.html b/en/devices/bluetooth/ble.html
new file mode 100644
index 00000000..15b909f1
--- /dev/null
+++ b/en/devices/bluetooth/ble.html
@@ -0,0 +1,148 @@
+<html devsite>
+  <head>
+    <title>Bluetooth Low Energy</title>
+    <meta name="project_path" value="/_project.yaml" />
+    <meta name="book_path" value="/_book.yaml" />
+  </head>
+  <body>
+    <!--
+      Copyright 2018 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.
+    -->
+
+    <p>
+      Bluetooth Low Energy (BLE), available in Android 4.3 and later, creates
+      short connections between devices to transfer bursts of data. BLE
+      remains in sleep mode when not connected. This lets BLE provide lower
+      bandwidth and reduced power consumption compared to Classic Bluetooth.
+      It is ideal for applications such as a heart-rate monitor or a wireless
+      keyboard. To use BLE, devices need to have a chipset that supports BLE.
+    </p>
+
+    <h2 id="implementation">Implementation</h2>
+
+      <p>
+        All current BLE application profiles are based on the
+        <a href="https://www.bluetooth.com/specifications/gatt">Generic
+        Attribute Profile</a> (GATT). When an Android device interacts with a
+        BLE device, the device that sends information is the server and the
+        device that receives information is the client. Android includes
+        <a href="https://developer.android.com/guide/topics/connectivity/bluetooth-le.html">
+        developer APIs for BLE</a>, including APIs for interactions between
+        GATT servers and GATT clients. To fully leverage the BLE APIs,
+        implement the
+        <a href="/devices/bluetooth/hci_requirements.html">
+        Android Bluetooth HCI Requirements</a>.
+      </p>
+
+    <h2 id="device-modes">Device modes</h2>
+
+      <p>
+        When using BLE, an Android device can act as a peripheral device, a
+        central device, or both. Peripheral mode lets devices send
+        advertisement packets. Central mode lets devices scan for
+        advertisements. An Android device acting as both a peripheral and
+        central device can communicate with other BLE peripheral devices while
+        sending advertisements in peripheral mode. Devices supporting
+        Bluetooth 4.1 and earlier can only use BLE in central mode. Older
+        device chipsets may not support BLE peripheral mode.
+      </p>
+
+    <h2 id="ble-scanning">BLE scanning</h2>
+
+      <p>
+        An Android device can target and scan for specific Bluetooth devices
+        more efficiently when using BLE. BLE APIs let app developers create
+        filters for finding devices with less involvement from the host
+        controller.
+      </p>
+
+      <aside class="caution">
+        <strong>Caution:</strong> BLE scanning needs location permissions as BLE
+        scanning identifies objects that could be used for geolocation. Turning
+        off Location services will turn off Bluetooth scanning.
+      </aside>
+
+      <h3 id="location-scanning">Location scanning</h3>
+
+        <p>
+          A device's location services can use Bluetooth to detect Bluetooth
+          beacons and provide a more accurate location. This is how users
+          enable the feature:
+        </p>
+
+        <ol>
+          <li>Go to <strong>Settings</strong> &gt; <strong> Security &amp;
+          Location</strong> &gt; <strong>Location</strong>.</li>
+          <li>Check that the Location <strong>On</strong>/<strong>Off</strong>
+            toggle is in the <strong>On</strong> position.</li>
+          <li>Go to <strong>Mode</strong>.</li>
+          <li>Select either <strong>High accuracy</strong> or <strong>Battery
+          saving</strong> mode.</li>
+        </ol>
+
+        <p>
+          Individual apps need location permissions to use BLE scanning, even
+          if they are scanning only to find devices to connect to. If the user
+          disables location scanning, or does not give an app location
+          permissions, then the app will not receive any BLE scanning results.
+        </p>
+
+        <p>
+          Users can disable system-level Bluetooth background scanning by
+          going to <strong>Settings</strong> &gt; <strong>Security &amp;
+          Location</strong> &gt; <strong>Location</strong> &gt; <strong>
+          Scanning</strong> and disabling the toggle for <strong>Bluetooth
+          scanning</strong>. This does not affect BLE scanning for location or
+          local devices.
+        </p>
+
+      <h3 id="filtering-scan-results">Filtering scan results</h3>
+
+        <p>
+          Android 6.0 and later includes BLE scanning and filter-matching on
+          the Bluetooth controller. A device can filter scan results and
+          report <strong>found</strong> and <strong>lost</strong> events
+          related to BLE devices to the application processor (AP). Filtering
+          also works for batch scans, which helps save power as BLE scanning is
+          offloaded to the firmware. Batch scans reduce how often the AP wakes
+          up due to BLE scanning for devices or beacons.
+        </p>
+
+        <p>
+          The <code>OnFound</code>/<code>OnLost</code> feature is implemented
+          in the Bluetooth controller and then tested to confirm that BLE
+          devices are not missed in scans. This provides power savings, and it
+          can also provide the following benefits:
+        </p>
+
+        <ul>
+          <li>For an <code>OnFound</code> event, the main AP wakes up upon the
+          discovery of a specific device.</li>
+          <li>For an <code>OnLost</code> event, the AP wakes up when a
+            specific device cannot be found.</li>
+          <li>Framework apps get fewer unwanted notifications when a nearby device is in range.</li>
+          <li>Continuous scans enable framework apps to be notified when a device is out of range.</li>
+        </ul>
+
+        <p>
+          A scan filter can be based on the discovery of a device's
+          advertisements (the <code>OnFound</code> event). The Java layer can
+          specify parameters such as first discovery (or a specified number of
+          advertisements since first discovery). Implement BLE filtering using
+          the <a href="/devices/bluetooth/hci_requirements#advertisement-packet-content-filter">
+          Advertising Packet Content Filter HCI command</a>.
+        </p>
+</body>
+</html>
\ No newline at end of file
diff --git a/en/devices/graphics/images/graphics_pipeline.png b/en/devices/graphics/images/graphics_pipeline.png
index 6033b4f9..60fb0fc1 100644
--- a/en/devices/graphics/images/graphics_pipeline.png
+++ b/en/devices/graphics/images/graphics_pipeline.png
diff --git a/en/devices/graphics/run-tests.html b/en/devices/graphics/run-tests.html
index 0eb83d00..7824e76b 100644
--- a/en/devices/graphics/run-tests.html
+++ b/en/devices/graphics/run-tests.html
@@ -271,7 +271,7 @@ supporting <code>NativeActivity,</code> use the following commands.</p>
 
 <pre class="devsite-terminal devsite-click-to-copy">
 adb -d shell am start -n com.drawelements.deqp/android.app.NativeActivity -e \
-cmdLine "deqp --deqp-case=dEQP-GLES2.info.* --deqp-log-filename=/sdcard/dEQP-Log.qpa
+'cmdLine "deqp --deqp-case=dEQP-GLES2.info.* --deqp-log-filename=/sdcard/dEQP-Log.qpa"'
 </pre>
 
 <h3 id=debugging_on_android>Debugging on Android</h3>
diff --git a/en/devices/tech/debug/native-memory.html b/en/devices/tech/debug/native-memory.html
index b690793d..afa0d220 100644
--- a/en/devices/tech/debug/native-memory.html
+++ b/en/devices/tech/debug/native-memory.html
@@ -21,6 +21,14 @@
       limitations under the License.
   -->
 
+<h2 id="asan">Address Sanitizer</h2>
+
+<p>Android platform developers use <a href="/devices/tech/debug/asan.html">AddressSanitizer</a>
+(ASan) to find memory bugs in C/C++.</p>
+
+</p>Since Android 8.0 (Oreo) it's also possible to use ASan to debug apps on non-rooted production
+devices. You can find instructions on the
+<a href="https://github.com/google/sanitizers/wiki/AddressSanitizerOnAndroidO">ASan wiki</a>.</p>
 
 <h2 id="malloc_debug">Malloc debug</h2>
 
diff --git a/en/devices/tech/debug/valgrind.html b/en/devices/tech/debug/valgrind.html
index 9ae0f088..6abbc999 100644
--- a/en/devices/tech/debug/valgrind.html
+++ b/en/devices/tech/debug/valgrind.html
@@ -25,9 +25,10 @@
 (for detecting memory-related errors in C and C++), Cachegrind (a cache
 profiler), Massif (a heap profiler), and several other tools.</p>
 
-<p class="note"><strong>Note:</strong> While you can use Valgrind for Android
-debugging, most Android platform developers use
-<a href="/devices/tech/debug/asan.html">AddressSanitizer</a> instead.</p>
+<p class="warning"><strong>Note:</strong> While you can still use Valgrind for Android
+debugging, Android platform developers use
+<a href="/devices/tech/debug/asan.html">AddressSanitizer</a> instead.
+Valgrind will be removed from the platform in a future release.</p>
 
 <h2 id=build-valgrind>Building Valgrind</h2>
 <p>To build Valgrind:</p>
diff --git a/en/devices/tech/ota/ab/index.html b/en/devices/tech/ota/ab/index.html
index c2a9c447..f494c825 100644
--- a/en/devices/tech/ota/ab/index.html
+++ b/en/devices/tech/ota/ab/index.html
@@ -21,7 +21,8 @@
       limitations under the License.
   -->
 
-    <p>A/B system updates, also known as seamless updates, ensure a workable
+    <p>
+      A/B system updates, also known as seamless updates, ensure a workable
       booting system remains on the disk during an <a href="/devices/tech/ota/index.html">
       over-the-air (OTA) update</a>. This approach reduces the likelihood of
       an inactive device after an update, which means fewer device
@@ -31,8 +32,10 @@
       updates successfully.
     </p>
 
-    <p>For more information about A/B system updates and how they work, see
+    <p>
+      For more information about A/B system updates and how they work, see
       <a href="#slots">Partition selection (slots)</a>.
+    </p>
 
     <p>A/B system updates provide the following benefits:</p>