<doc>
  <legacy_id>1121</legacy_id>
  <name>debugDo</name>
  <type>command</type>
  <syntax>
    <example>debugDo <i>statementList</i></example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Writing LiveCode</category>
  </classification>
  <references>
    <command tag="do">do Command</command>
    <command tag="send">send Command</command>
    <property tag="traceDelay">traceDelay Property</property>
    <property tag="traceReturn">traceReturn Property</property>
    <property tag="traceStack">traceStack Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
  </security>
  <summary><glossary tag="execute">Executes</glossary> a list of <glossary tag="statement">statements</glossary> with additional <glossary tag="debug">debugging</glossary> information when in the <glossary tag="debugger">debugger</glossary>.</summary>
  <examples>
    <example>debugDo "beep"</example>
    <example>debugDo commandsList</example>
  </examples>
  <description>
    <p>The <b>debugDo</b> <glossary tag="command">command</glossary> is used by LiveCode's <keyword tag="message box">message box</keyword> and <glossary tag="debugger">debugger</glossary>.</p><p/><p><b>Parameters:</b></p><p>The <i>statementList</i> is a <glossary tag="LiveCode">LiveCode</glossary> <glossary tag="statement">statement</glossary>, a <glossary tag="container">container</glossary> with one or more <glossary tag="statement">statements</glossary>, or a <keyword tag="string">string</keyword> that <glossary tag="evaluate">evaluates</glossary> to a <glossary tag="statement">statement</glossary>.</p><p/><p><b>Comments:</b></p><p>Normally, you should use the <b>do</b> <glossary tag="command">command</glossary>; consider using <b>debugDo</b> only if you are writing a debugger or similar utility, or if you need to <glossary tag="debug">debug</glossary> the <glossary tag="statement">statement list</glossary> sent by a <command tag="do">do</command> command.</p><p/><p>When the debugger is active, you can use <b>debugDo</b>  to access <glossary tag="local variable">local variables</glossary> using the <keyword tag="message box">message box</keyword>. If you enter a <b>debugDo</b> <glossary tag="statement">statement</glossary> into the <keyword tag="message box">message box</keyword>, and the <glossary tag="statement">statement</glossary> refers to a <glossary tag="local variable">local variable</glossary>, the <glossary tag="variable">variable's</glossary> <function tag="value">value</function> is the current <function tag="value">value</function> in the <glossary tag="handler">handler</glossary> that the <glossary tag="debugger">debugger</glossary> is <glossary tag="execute">executing</glossary>. This capability is useful if you want to track the current <function tag="value">value</function> of a <glossary tag="variable">variable</glossary> in a <glossary tag="handler">handler</glossary> you're <glossary tag="debug">debugging</glossary>.</p><p/><p><img src="202653"/> <b>Important!</b> The details of this <glossary tag="command">command</glossary> may change in future releases.</p>
  </description>
</doc>