From 9b73b8328544e04d0265e0cb9fb821d194590e3b Mon Sep 17 00:00:00 2001
From: Ricardo Cervera <rcervera@google.com>
Date: Tue, 21 Oct 2014 10:01:14 -0700
Subject: docs: Add instructions to attach debugger to a running process.

https://code.google.com/p/android/issues/detail?id=77527

Change-Id: I0c8d0be14c3e240688a31dacb5690ec821fc2adb
---
 docs/html/images/tools/as-attach.png     | Bin 0 -> 475 bytes
 docs/html/sdk/installing/studio-debug.jd |  22 +++++++++++++++++++++-
 2 files changed, 21 insertions(+), 1 deletion(-)
 create mode 100644 docs/html/images/tools/as-attach.png

diff --git a/docs/html/images/tools/as-attach.png b/docs/html/images/tools/as-attach.png
new file mode 100644
index 000000000000..c572b1ef852f
Binary files /dev/null and b/docs/html/images/tools/as-attach.png differ
diff --git a/docs/html/sdk/installing/studio-debug.jd b/docs/html/sdk/installing/studio-debug.jd
index 2e3e137be0c6..b0484009af3a 100644
--- a/docs/html/sdk/installing/studio-debug.jd
+++ b/docs/html/sdk/installing/studio-debug.jd
@@ -6,7 +6,11 @@ page.title=Debugging with Android Studio
 <div id="qv">
 <h2>In this document</h2>
 <ol>
-  <li><a href="#runDebug">Run your App in Debug Mode</a></li>
+  <li><a href="#runDebug">Run your App in Debug Mode</a>
+    <ol>
+      <li><a href="#attachDebug">Attach the debugger to a running process</a></li>
+    </ol>
+  </li>
   <li><a href="#systemLog">Use the System Log</a>
     <ol>
       <li><a href="#systemLogWrite">Write log messages in your code</a></li>
@@ -94,6 +98,22 @@ window also provides other debugging tools covered in the following sections.</p
 <p class="img-caption"><strong>Figure 2.</strong> The Debug tool window in Android Studio showing
 the current thread and the object tree for a variable.</p>
 
+<h3 id="attachDebug">Attach the debugger to a running process</h3>
+
+<p>You don't always have to restart your app to debug it. To debug an app that you're already
+running:</p>
+
+<ol>
+<li>Click <strong>Attach debugger to Android proccess</strong>
+<img src="{@docRoot}images/tools/as-attach.png" alt=""
+style="vertical-align:bottom;margin:0;height:20px"/>.</li>
+<li>In the <em>Choose Process</em> window, select the device and app you want to attach the
+debugger to.</li>
+<li>To open the <em>Debug</em> tool window, click <strong>Debug</strong>
+<img src="{@docRoot}images/tools/as-debugwindowbutton.png"
+alt="" style="vertical-align:bottom;margin:0;height:20px"/>.</li>
+</ol>
+
 
 <h2 id="systemLog">Use the System Log</h2>
 
-- 
cgit v1.2.3-59-g8ed1b