<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>