--- a/Documentation/Source/eric5.DebugClients.Python3.DebugBase.html	Thu Jan 14 17:27:31 2010 +0000
+++ b/Documentation/Source/eric5.DebugClients.Python3.DebugBase.html	Thu Jan 14 18:35:52 2010 +0000
@@ -22,7 +22,7 @@
 <body><a NAME="top" ID="top"></a>
 <h1>eric5.DebugClients.Python3.DebugBase</h1>
 <p>
-&#77;&#111;&#100;&#117;&#108;&#101; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103; &#98;&#97;&#115;&#101; &#99;&#108;&#97;&#115;&#115;.
+Module implementing the debug base class.
 </p>
 <h3>Global Attributes</h3>
 <table>
@@ -32,27 +32,27 @@
 <table>
 <tr>
 <td><a href="#DebugBase">DebugBase</a></td>
-<td>&#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#98;&#97;&#115;&#101; &#99;&#108;&#97;&#115;&#115; &#111;&#102; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114;.</td>
+<td>Class implementing base class of the debugger.</td>
 </tr>
 </table>
 <h3>Functions</h3>
 <table>
 <tr>
 <td><a href="#printerr">printerr</a></td>
-<td>&#77;&#111;&#100;&#117;&#108;&#101; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110; &#117;&#115;&#101;&#100; &#102;&#111;&#114; &#100;&#101;&#98;&#117;&#103;&#103;&#105;&#110;&#103; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103; &#99;&#108;&#105;&#101;&#110;&#116;.</td>
+<td>Module function used for debugging the debug client.</td>
 </tr><tr>
 <td><a href="#setRecursionLimit">setRecursionLimit</a></td>
-<td>&#77;&#111;&#100;&#117;&#108;&#101; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110; &#116;&#111; &#115;&#101;&#116; &#116;&#104;&#101; &#114;&#101;&#99;&#117;&#114;&#115;&#105;&#111;&#110; &#108;&#105;&#109;&#105;&#116;.</td>
+<td>Module function to set the recursion limit.</td>
 </tr>
 </table>
 <hr /><hr />
 <a NAME="DebugBase" ID="DebugBase"></a>
 <h2>DebugBase</h2>
 <p>
-    &#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#98;&#97;&#115;&#101; &#99;&#108;&#97;&#115;&#115; &#111;&#102; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114;.
+    Class implementing base class of the debugger.
 </p><p>
-    &#80;&#114;&#111;v&#105;&#100;&#101;&#115; &#115;&#105;&#109;&#112;&#108;&#101; w&#114;&#97;&#112;&#112;&#101;&#114; &#109;&#101;&#116;&#104;&#111;&#100;&#115; &#97;&#114;&#111;&#117;&#110;&#100; &#98;&#100;&#98; &#102;&#111;&#114; &#116;&#104;&#101; '&#111;w&#110;&#105;&#110;&#103;' &#99;&#108;&#105;&#101;&#110;&#116; &#116;&#111;
-    &#99;&#97;&#108;&#108; &#116;&#111; &#115;&#116;&#101;&#112; &#101;&#116;&#99;.
+    Provides simple wrapper methods around bdb for the 'owning' client to
+    call to step etc.
 </p>
 <h3>Derived from</h3>
 bdb.Bdb
@@ -64,570 +64,570 @@
 <table>
 <tr>
 <td><a href="#DebugBase.__init__">DebugBase</a></td>
-<td>&#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;</td>
+<td>Constructor</td>
 </tr><tr>
 <td><a href="#DebugBase.__do_clear">__do_clear</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#99;&#97;&#108;&#108;&#101;&#100; &#116;&#111; &#99;&#108;&#101;&#97;&#114; &#97; &#116;&#101;&#109;&#112;&#111;&#114;&#97;&#114;y &#98;&#114;&#101;&#97;&#107;&#112;&#111;&#105;&#110;&#116;.</td>
+<td>Private method called to clear a temporary breakpoint.</td>
 </tr><tr>
 <td><a href="#DebugBase.__do_clearWatch">__do_clearWatch</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#99;&#97;&#108;&#108;&#101;&#100; &#116;&#111; &#99;&#108;&#101;&#97;&#114; &#97; &#116;&#101;&#109;&#112;&#111;&#114;&#97;&#114;y w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110;.</td>
+<td>Private method called to clear a temporary watch expression.</td>
 </tr><tr>
 <td><a href="#DebugBase.__effective">__effective</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#100;&#101;&#116;&#101;&#114;&#109;&#105;&#110;&#101;, &#105;&#102; &#97; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; &#105;&#115; &#101;&#102;&#102;&#101;&#99;&#116;&#105;v&#101;.</td>
+<td>Private method to determine, if a watch expression is effective.</td>
 </tr><tr>
 <td><a href="#DebugBase.__extractExceptionName">__extractExceptionName</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#101;x&#116;&#114;&#97;&#99;&#116; &#116;&#104;&#101; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110; &#110;&#97;&#109;&#101; &#103;&#105;v&#101;&#110; &#116;&#104;&#101; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110; &#116;y&#112;&#101; &#111;&#98;&#106;&#101;&#99;&#116;.</td>
+<td>Private method to extract the exception name given the exception type object.</td>
 </tr><tr>
 <td><a href="#DebugBase.__extract_stack">__extract_stack</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#109;&#98;&#101;&#114; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#97; &#108;&#105;&#115;&#116; &#111;&#102; &#115;&#116;&#97;&#99;&#107; &#102;&#114;&#97;&#109;&#101;&#115;.</td>
+<td>Private member to return a list of stack frames.</td>
 </tr><tr>
 <td><a href="#DebugBase.__skip_it">__skip_it</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#102;&#105;&#108;&#116;&#101;&#114; &#111;&#117;&#116; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#102;&#105;&#108;&#101;&#115;.</td>
+<td>Private method to filter out debugger files.</td>
 </tr><tr>
 <td><a href="#DebugBase.break_anywhere">break_anywhere</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#100;&#111; &#115;&#111;&#109;&#101; &#115;&#112;&#101;&#99;&#105;&#97;&#108; &#116;&#104;&#105;&#110;&#103;&#115;.</td>
+<td>Reimplemented from bdb.py to do some special things.</td>
 </tr><tr>
 <td><a href="#DebugBase.break_here">break_here</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#102;&#105;x &#116;&#104;&#101; &#102;&#105;&#108;&#101;&#110;&#97;&#109;&#101; &#102;&#114;&#111;&#109; &#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101;.</td>
+<td>Reimplemented from bdb.py to fix the filename from the frame.</td>
 </tr><tr>
 <td><a href="#DebugBase.clear_watch">clear_watch</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#108;&#101;&#97;&#114; &#97; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110;.</td>
+<td>Public method to clear a watch expression.</td>
 </tr><tr>
 <td><a href="#DebugBase.dispatch_exception">dispatch_exception</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#97;&#108;w&#97;y&#115; &#99;&#97;&#108;&#108; &#117;&#115;&#101;&#114;&#95;&#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110;.</td>
+<td>Reimplemented from bdb.py to always call user_exception.</td>
 </tr><tr>
 <td><a href="#DebugBase.dispatch_line">dispatch_line</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#100;&#111; &#115;&#111;&#109;&#101; &#115;&#112;&#101;&#99;&#105;&#97;&#108; &#116;&#104;&#105;&#110;&#103;&#115;.</td>
+<td>Reimplemented from bdb.py to do some special things.</td>
 </tr><tr>
 <td><a href="#DebugBase.dispatch_return">dispatch_return</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#104;&#97;&#110;&#100;&#108;&#101; &#112;&#97;&#115;&#115;&#105;v&#101; &#109;&#111;&#100;&#101; &#99;&#108;&#101;&#97;&#110;&#108;y.</td>
+<td>Reimplemented from bdb.py to handle passive mode cleanly.</td>
 </tr><tr>
 <td><a href="#DebugBase.fix_frame_filename">fix_frame_filename</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#117;&#115;&#101;&#100; &#116;&#111; &#102;&#105;x&#117;&#112; &#116;&#104;&#101; &#102;&#105;&#108;&#101;&#110;&#97;&#109;&#101; &#102;&#111;&#114; &#97; &#103;&#105;v&#101;&#110; &#102;&#114;&#97;&#109;&#101;.</td>
+<td>Public method used to fixup the filename for a given frame.</td>
 </tr><tr>
 <td><a href="#DebugBase.getCurrentFrame">getCurrentFrame</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#102;&#114;&#97;&#109;&#101;.</td>
+<td>Public method to return the current frame.</td>
 </tr><tr>
 <td><a href="#DebugBase.getEvent">getEvent</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#108;&#97;&#115;&#116; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#101;v&#101;&#110;&#116;.</td>
+<td>Public method to return the last debugger event.</td>
 </tr><tr>
 <td><a href="#DebugBase.getStack">getStack</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#116;&#104;&#101; &#115;&#116;&#97;&#99;&#107;.</td>
+<td>Public method to get the stack.</td>
 </tr><tr>
 <td><a href="#DebugBase.get_break">get_break</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#103;&#101;&#116; &#116;&#104;&#101; &#102;&#105;&#114;&#115;&#116; &#98;&#114;&#101;&#97;&#107;&#112;&#111;&#105;&#110;&#116; &#111;&#102; &#97; &#112;&#97;&#114;&#116;&#105;&#99;&#117;&#108;&#97;&#114; &#108;&#105;&#110;&#101;.</td>
+<td>Reimplemented from bdb.py to get the first breakpoint of a particular line.</td>
 </tr><tr>
 <td><a href="#DebugBase.get_watch">get_watch</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#97; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110;.</td>
+<td>Public method to get a watch expression.</td>
 </tr><tr>
 <td><a href="#DebugBase.go">go</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#115;&#117;&#109;&#101; &#116;&#104;&#101; &#116;&#104;&#114;&#101;&#97;&#100;.</td>
+<td>Public method to resume the thread.</td>
 </tr><tr>
 <td><a href="#DebugBase.isBroken">isBroken</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#98;&#114;&#111;&#107;&#101;&#110; &#115;&#116;&#97;&#116;&#101; &#111;&#102; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114;.</td>
+<td>Public method to return the broken state of the debugger.</td>
 </tr><tr>
 <td><a href="#DebugBase.profile">profile</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#117;&#115;&#101;&#100; &#116;&#111; &#116;&#114;&#97;&#99;&#101; &#115;&#111;&#109;&#101; &#115;&#116;&#117;&#102;&#102; &#105;&#110;&#100;&#101;&#112;&#101;&#110;&#100;&#97;&#110;&#116; &#111;&#102; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#116;&#114;&#97;&#99;&#101; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;.</td>
+<td>Public method used to trace some stuff independant of the debugger trace function.</td>
 </tr><tr>
 <td><a href="#DebugBase.setRecursionDepth">setRecursionDepth</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#100;&#101;&#116;&#101;&#114;&#109;&#105;&#110;&#101; &#116;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#114;&#101;&#99;&#117;&#114;&#115;&#105;&#111;&#110; &#100;&#101;&#112;&#116;&#104;.</td>
+<td>Public method to determine the current recursion depth.</td>
 </tr><tr>
 <td><a href="#DebugBase.set_continue">set_continue</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#97;&#108;w&#97;y&#115; &#103;&#101;&#116; &#105;&#110;&#102;&#111;&#114;&#109;&#101;&#100; &#111;&#102; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110;&#115;.</td>
+<td>Reimplemented from bdb.py to always get informed of exceptions.</td>
 </tr><tr>
 <td><a href="#DebugBase.set_quit">set_quit</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#113;&#117;&#105;&#116;.</td>
+<td>Public method to quit.</td>
 </tr><tr>
 <td><a href="#DebugBase.set_trace">set_trace</a></td>
-<td>&#79;v&#101;&#114;&#114;&#105;&#100;&#100;&#101;&#110; &#109;&#101;&#116;&#104;&#111;&#100; &#111;&#102; &#98;&#100;&#98;.&#112;y &#116;&#111; &#100;&#111; &#115;&#111;&#109;&#101; &#115;&#112;&#101;&#99;&#105;&#97;&#108; &#115;&#101;&#116;&#117;&#112;.</td>
+<td>Overridden method of bdb.py to do some special setup.</td>
 </tr><tr>
 <td><a href="#DebugBase.set_watch">set_watch</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#101;&#116; &#97; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110;.</td>
+<td>Public method to set a watch expression.</td>
 </tr><tr>
 <td><a href="#DebugBase.step">step</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#112;&#101;&#114;&#102;&#111;&#114;&#109; &#97; &#115;&#116;&#101;&#112; &#111;&#112;&#101;&#114;&#97;&#116;&#105;&#111;&#110; &#105;&#110; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100;.</td>
+<td>Public method to perform a step operation in this thread.</td>
 </tr><tr>
 <td><a href="#DebugBase.stepOut">stepOut</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#112;&#101;&#114;&#102;&#111;&#114;&#109; &#97; &#115;&#116;&#101;&#112; &#111;&#117;&#116; &#111;&#102; &#116;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#99;&#97;&#108;&#108;.</td>
+<td>Public method to perform a step out of the current call.</td>
 </tr><tr>
 <td><a href="#DebugBase.stop_here">stop_here</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#116;&#111; &#102;&#105;&#108;&#116;&#101;&#114; &#111;&#117;&#116; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#102;&#105;&#108;&#101;&#115;.</td>
+<td>Reimplemented to filter out debugger files.</td>
 </tr><tr>
 <td><a href="#DebugBase.trace_dispatch">trace_dispatch</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#100;&#111; &#115;&#111;&#109;&#101; &#115;&#112;&#101;&#99;&#105;&#97;&#108; &#116;&#104;&#105;&#110;&#103;&#115;.</td>
+<td>Reimplemented from bdb.py to do some special things.</td>
 </tr><tr>
 <td><a href="#DebugBase.user_exception">user_exception</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#116;&#111; &#114;&#101;&#112;&#111;&#114;&#116; &#97;&#110; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110; &#116;&#111; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103; &#115;&#101;&#114;v&#101;&#114;.</td>
+<td>Reimplemented to report an exception to the debug server.</td>
 </tr><tr>
 <td><a href="#DebugBase.user_line">user_line</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#116;&#111; &#104;&#97;&#110;&#100;&#108;&#101; &#116;&#104;&#101; &#112;&#114;&#111;&#103;&#114;&#97;&#109; &#97;&#98;&#111;&#117;&#116; &#116;&#111; &#101;x&#101;&#99;&#117;&#116;&#101; &#97; &#112;&#97;&#114;&#116;&#105;&#99;&#117;&#108;&#97;&#114; &#108;&#105;&#110;&#101;.</td>
+<td>Reimplemented to handle the program about to execute a particular line.</td>
 </tr><tr>
 <td><a href="#DebugBase.user_return">user_return</a></td>
-<td>&#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#116;&#111; &#114;&#101;&#112;&#111;&#114;&#116; &#112;&#114;&#111;&#103;&#114;&#97;&#109; &#116;&#101;&#114;&#109;&#105;&#110;&#97;&#116;&#105;&#111;&#110; &#116;&#111; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103; &#115;&#101;&#114;v&#101;&#114;.</td>
+<td>Reimplemented to report program termination to the debug server.</td>
 </tr>
 </table>
 <a NAME="DebugBase.__init__" ID="DebugBase.__init__"></a>
 <h4>DebugBase (Constructor)</h4>
 <b>DebugBase</b>(<i>dbgClient</i>)
 <p>
-        &#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;
+        Constructor
 </p><dl>
 <dt><i>dbgClient</i></dt>
 <dd>
-&#116;&#104;&#101; &#111;w&#110;&#105;&#110;&#103; &#99;&#108;&#105;&#101;&#110;&#116;
+the owning client
 </dd>
 </dl><a NAME="DebugBase.__do_clear" ID="DebugBase.__do_clear"></a>
 <h4>DebugBase.__do_clear</h4>
 <b>__do_clear</b>(<i>filename, lineno</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#99;&#97;&#108;&#108;&#101;&#100; &#116;&#111; &#99;&#108;&#101;&#97;&#114; &#97; &#116;&#101;&#109;&#112;&#111;&#114;&#97;&#114;y &#98;&#114;&#101;&#97;&#107;&#112;&#111;&#105;&#110;&#116;.
+        Private method called to clear a temporary breakpoint.
 </p><dl>
 <dt><i>filename</i></dt>
 <dd>
-&#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#102;&#105;&#108;&#101; &#116;&#104;&#101; &#98;&#112; &#98;&#101;&#108;&#111;&#110;&#103;&#115; &#116;&#111;
+name of the file the bp belongs to
 </dd><dt><i>lineno</i></dt>
 <dd>
-&#108;&#105;&#110;&#101;&#110;&#117;&#109;&#98;&#101;&#114; &#111;&#102; &#116;&#104;&#101; &#98;&#112;
+linenumber of the bp
 </dd>
 </dl><a NAME="DebugBase.__do_clearWatch" ID="DebugBase.__do_clearWatch"></a>
 <h4>DebugBase.__do_clearWatch</h4>
 <b>__do_clearWatch</b>(<i>cond</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#99;&#97;&#108;&#108;&#101;&#100; &#116;&#111; &#99;&#108;&#101;&#97;&#114; &#97; &#116;&#101;&#109;&#112;&#111;&#114;&#97;&#114;y w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110;.
+        Private method called to clear a temporary watch expression.
 </p><dl>
 <dt><i>cond</i></dt>
 <dd>
-&#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; &#111;&#102; &#116;&#104;&#101; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; &#116;&#111; &#98;&#101; &#99;&#108;&#101;&#97;&#114;&#101;&#100; (&#115;&#116;&#114;&#105;&#110;&#103;)
+expression of the watch expression to be cleared (string)
 </dd>
 </dl><a NAME="DebugBase.__effective" ID="DebugBase.__effective"></a>
 <h4>DebugBase.__effective</h4>
 <b>__effective</b>(<i>frame</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#100;&#101;&#116;&#101;&#114;&#109;&#105;&#110;&#101;, &#105;&#102; &#97; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; &#105;&#115; &#101;&#102;&#102;&#101;&#99;&#116;&#105;v&#101;.
+        Private method to determine, if a watch expression is effective.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#116;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#101;x&#101;&#99;&#117;&#116;&#105;&#111;&#110; &#102;&#114;&#97;&#109;&#101;
+the current execution frame
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#116;&#117;&#112;&#108;&#101; &#111;&#102; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; &#97;&#110;&#100; &#97; &#102;&#108;&#97;&#103; &#116;&#111; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#101;, &#116;&#104;&#97;&#116; &#97; &#116;&#101;&#109;&#112;&#111;&#114;&#97;&#114;y
-            w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; &#109;&#97;y &#98;&#101; &#100;&#101;&#108;&#101;&#116;&#101;&#100; (&#98;&#100;&#98;.&#66;&#114;&#101;&#97;&#107;&#112;&#111;&#105;&#110;&#116;, &#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+tuple of watch expression and a flag to indicate, that a temporary
+            watch expression may be deleted (bdb.Breakpoint, boolean)
 </dd>
 </dl><a NAME="DebugBase.__extractExceptionName" ID="DebugBase.__extractExceptionName"></a>
 <h4>DebugBase.__extractExceptionName</h4>
 <b>__extractExceptionName</b>(<i>exctype</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#101;x&#116;&#114;&#97;&#99;&#116; &#116;&#104;&#101; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110; &#110;&#97;&#109;&#101; &#103;&#105;v&#101;&#110; &#116;&#104;&#101; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110;
-        &#116;y&#112;&#101; &#111;&#98;&#106;&#101;&#99;&#116;.
+        Private method to extract the exception name given the exception
+        type object.
 </p><dl>
 <dt><i>exctype</i></dt>
 <dd>
-&#116;y&#112;&#101; &#111;&#102; &#116;&#104;&#101; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110;
+type of the exception
 </dd>
 </dl><a NAME="DebugBase.__extract_stack" ID="DebugBase.__extract_stack"></a>
 <h4>DebugBase.__extract_stack</h4>
 <b>__extract_stack</b>(<i>exctb</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#109;&#98;&#101;&#114; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#97; &#108;&#105;&#115;&#116; &#111;&#102; &#115;&#116;&#97;&#99;&#107; &#102;&#114;&#97;&#109;&#101;&#115;.
+        Private member to return a list of stack frames.
 </p><dl>
 <dt><i>exctb</i></dt>
 <dd>
-&#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110; &#116;&#114;&#97;&#99;&#101;&#98;&#97;&#99;&#107;
+exception traceback
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#108;&#105;&#115;&#116; &#111;&#102; &#115;&#116;&#97;&#99;&#107; &#102;&#114;&#97;&#109;&#101;&#115;
+list of stack frames
 </dd>
 </dl><a NAME="DebugBase.__skip_it" ID="DebugBase.__skip_it"></a>
 <h4>DebugBase.__skip_it</h4>
 <b>__skip_it</b>(<i>frame</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#102;&#105;&#108;&#116;&#101;&#114; &#111;&#117;&#116; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#102;&#105;&#108;&#101;&#115;.
+        Private method to filter out debugger files.
 </p><p>
-        &#84;&#114;&#97;&#99;&#105;&#110;&#103; &#105;&#115; &#116;&#117;&#114;&#110;&#101;&#100; &#111;&#102;&#102; &#102;&#111;&#114; &#102;&#105;&#108;&#101;&#115; &#116;&#104;&#97;&#116; &#97;&#114;&#101; &#112;&#97;&#114;&#116; &#111;&#102; &#116;&#104;&#101;
-        &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#116;&#104;&#97;&#116; &#97;&#114;&#101; &#99;&#97;&#108;&#108;&#101;&#100; &#102;&#114;&#111;&#109; &#116;&#104;&#101; &#97;&#112;&#112;&#108;&#105;&#99;&#97;&#116;&#105;&#111;&#110; &#98;&#101;&#105;&#110;&#103; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#100;.
+        Tracing is turned off for files that are part of the
+        debugger that are called from the application being debugged.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101; &#111;&#98;&#106;&#101;&#99;&#116;
+the frame object
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; w&#104;&#101;&#116;&#104;&#101;&#114; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#115;&#104;&#111;&#117;&#108;&#100; &#115;&#107;&#105;&#112; &#116;&#104;&#105;&#115; &#102;&#114;&#97;&#109;&#101;
+flag indicating whether the debugger should skip this frame
 </dd>
 </dl><a NAME="DebugBase.break_anywhere" ID="DebugBase.break_anywhere"></a>
 <h4>DebugBase.break_anywhere</h4>
 <b>break_anywhere</b>(<i>frame</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#100;&#111; &#115;&#111;&#109;&#101; &#115;&#112;&#101;&#99;&#105;&#97;&#108; &#116;&#104;&#105;&#110;&#103;&#115;.
+        Reimplemented from bdb.py to do some special things.
 </p><p>
-        &#84;&#104;&#101;&#115;&#101; &#115;&#112;&#101;&#99;&#105;&#97;&#108;&#105;&#116;y &#105;&#115; &#116;&#111; &#102;&#105;x &#116;&#104;&#101; &#102;&#105;&#108;&#101;&#110;&#97;&#109;&#101; &#102;&#114;&#111;&#109; &#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101;
-        (&#115;&#101;&#101; &#102;&#105;x&#95;&#102;&#114;&#97;&#109;&#101;&#95;&#102;&#105;&#108;&#101;&#110;&#97;&#109;&#101; &#102;&#111;&#114; &#109;&#111;&#114;&#101; &#105;&#110;&#102;&#111;).
+        These speciality is to fix the filename from the frame
+        (see fix_frame_filename for more info).
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101; &#111;&#98;&#106;&#101;&#99;&#116;
+the frame object
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#98;&#114;&#101;&#97;&#107; &#115;&#116;&#97;&#116;&#117;&#115; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating the break status (boolean)
 </dd>
 </dl><a NAME="DebugBase.break_here" ID="DebugBase.break_here"></a>
 <h4>DebugBase.break_here</h4>
 <b>break_here</b>(<i>frame</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#102;&#105;x &#116;&#104;&#101; &#102;&#105;&#108;&#101;&#110;&#97;&#109;&#101; &#102;&#114;&#111;&#109; &#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101;. 
+        Reimplemented from bdb.py to fix the filename from the frame. 
 </p><p>
-        &#83;&#101;&#101; &#102;&#105;x&#95;&#102;&#114;&#97;&#109;&#101;&#95;&#102;&#105;&#108;&#101;&#110;&#97;&#109;&#101; &#102;&#111;&#114; &#109;&#111;&#114;&#101; &#105;&#110;&#102;&#111;.
+        See fix_frame_filename for more info.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101; &#111;&#98;&#106;&#101;&#99;&#116;
+the frame object
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#98;&#114;&#101;&#97;&#107; &#115;&#116;&#97;&#116;&#117;&#115; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating the break status (boolean)
 </dd>
 </dl><a NAME="DebugBase.clear_watch" ID="DebugBase.clear_watch"></a>
 <h4>DebugBase.clear_watch</h4>
 <b>clear_watch</b>(<i>cond</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#108;&#101;&#97;&#114; &#97; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110;.
+        Public method to clear a watch expression.
 </p><dl>
 <dt><i>cond</i></dt>
 <dd>
-&#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; &#111;&#102; &#116;&#104;&#101; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; &#116;&#111; &#98;&#101; &#99;&#108;&#101;&#97;&#114;&#101;&#100; (&#115;&#116;&#114;&#105;&#110;&#103;)
+expression of the watch expression to be cleared (string)
 </dd>
 </dl><a NAME="DebugBase.dispatch_exception" ID="DebugBase.dispatch_exception"></a>
 <h4>DebugBase.dispatch_exception</h4>
 <b>dispatch_exception</b>(<i>frame, arg</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#97;&#108;w&#97;y&#115; &#99;&#97;&#108;&#108; &#117;&#115;&#101;&#114;&#95;&#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110;.
+        Reimplemented from bdb.py to always call user_exception.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#84;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#115;&#116;&#97;&#99;&#107; &#102;&#114;&#97;&#109;&#101;.
+The current stack frame.
 </dd><dt><i>arg</i></dt>
 <dd>
-&#84;&#104;&#101; &#97;&#114;&#103;&#117;&#109;&#101;&#110;&#116;&#115;
+The arguments
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#108;&#111;&#99;&#97;&#108; &#116;&#114;&#97;&#99;&#101; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;
+local trace function
 </dd>
 </dl><a NAME="DebugBase.dispatch_line" ID="DebugBase.dispatch_line"></a>
 <h4>DebugBase.dispatch_line</h4>
 <b>dispatch_line</b>(<i>frame</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#100;&#111; &#115;&#111;&#109;&#101; &#115;&#112;&#101;&#99;&#105;&#97;&#108; &#116;&#104;&#105;&#110;&#103;&#115;.
+        Reimplemented from bdb.py to do some special things.
 </p><p>
-        &#84;&#104;&#105;&#115; &#115;&#112;&#101;&#99;&#105;&#97;&#108;&#105;&#116;y &#105;&#115; &#116;&#111; &#99;&#104;&#101;&#99;&#107; &#116;&#104;&#101; &#99;&#111;&#110;&#110;&#101;&#99;&#116;&#105;&#111;&#110; &#116;&#111; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103; &#115;&#101;&#114;v&#101;&#114;
-        &#102;&#111;&#114; &#110;&#101;w &#101;v&#101;&#110;&#116;&#115; (&#105;.&#101;. &#110;&#101;w &#98;&#114;&#101;&#97;&#107;&#112;&#111;&#105;&#110;&#116;&#115;) w&#104;&#105;&#108;&#101; w&#101; &#97;&#114;&#101; &#103;&#111;&#105;&#110;&#103; &#116;&#104;&#114;&#111;&#117;&#103;&#104;
-        &#116;&#104;&#101; &#99;&#111;&#100;&#101;.
+        This speciality is to check the connection to the debug server
+        for new events (i.e. new breakpoints) while we are going through
+        the code.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#84;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#115;&#116;&#97;&#99;&#107; &#102;&#114;&#97;&#109;&#101;.
+The current stack frame.
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#108;&#111;&#99;&#97;&#108; &#116;&#114;&#97;&#99;&#101; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;
+local trace function
 </dd>
 </dl><a NAME="DebugBase.dispatch_return" ID="DebugBase.dispatch_return"></a>
 <h4>DebugBase.dispatch_return</h4>
 <b>dispatch_return</b>(<i>frame, arg</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#104;&#97;&#110;&#100;&#108;&#101; &#112;&#97;&#115;&#115;&#105;v&#101; &#109;&#111;&#100;&#101; &#99;&#108;&#101;&#97;&#110;&#108;y.
+        Reimplemented from bdb.py to handle passive mode cleanly.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#84;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#115;&#116;&#97;&#99;&#107; &#102;&#114;&#97;&#109;&#101;.
+The current stack frame.
 </dd><dt><i>arg</i></dt>
 <dd>
-&#84;&#104;&#101; &#97;&#114;&#103;&#117;&#109;&#101;&#110;&#116;&#115;
+The arguments
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#108;&#111;&#99;&#97;&#108; &#116;&#114;&#97;&#99;&#101; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;
+local trace function
 </dd>
 </dl><a NAME="DebugBase.fix_frame_filename" ID="DebugBase.fix_frame_filename"></a>
 <h4>DebugBase.fix_frame_filename</h4>
 <b>fix_frame_filename</b>(<i>frame</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#117;&#115;&#101;&#100; &#116;&#111; &#102;&#105;x&#117;&#112; &#116;&#104;&#101; &#102;&#105;&#108;&#101;&#110;&#97;&#109;&#101; &#102;&#111;&#114; &#97; &#103;&#105;v&#101;&#110; &#102;&#114;&#97;&#109;&#101;.
+        Public method used to fixup the filename for a given frame.
 </p><p>
-        &#84;&#104;&#101; &#108;&#111;&#103;&#105;&#99; &#101;&#109;&#112;&#108;&#111;y&#101;&#100; &#104;&#101;&#114;&#101; &#105;&#115; &#116;&#104;&#97;&#116; &#105;&#102; &#97; &#109;&#111;&#100;&#117;&#108;&#101; w&#97;&#115; &#108;&#111;&#97;&#100;&#101;&#100;
-        &#102;&#114;&#111;&#109; &#97; .&#112;y&#99; &#102;&#105;&#108;&#101;, &#116;&#104;&#101;&#110; &#116;&#104;&#101; &#99;&#111;&#114;&#114;&#101;&#99;&#116; .&#112;y &#116;&#111; &#111;&#112;&#101;&#114;&#97;&#116;&#101; w&#105;&#116;&#104;
-        &#115;&#104;&#111;&#117;&#108;&#100; &#98;&#101; &#105;&#110; &#116;&#104;&#101; &#115;&#97;&#109;&#101; &#112;&#97;&#116;&#104; &#97;&#115; &#116;&#104;&#101; .&#112;y&#99;. &#84;&#104;&#101; &#114;&#101;&#97;&#115;&#111;&#110; &#116;&#104;&#105;&#115;
-        &#108;&#111;&#103;&#105;&#99; &#105;&#115; &#110;&#101;&#101;&#100;&#101;&#100; &#105;&#115; &#116;&#104;&#97;&#116; w&#104;&#101;&#110; &#97; .&#112;y&#99; &#102;&#105;&#108;&#101; &#105;&#115; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101;&#100;, &#116;&#104;&#101;
-        &#102;&#105;&#108;&#101;&#110;&#97;&#109;&#101; &#101;&#109;&#98;&#101;&#100;&#100;&#101;&#100; &#97;&#110;&#100; &#116;&#104;&#117;&#115; w&#104;&#97;&#116; &#105;&#115; &#114;&#101;&#97;&#100;&#97;&#98;&#108;&#101; &#105;&#110; &#116;&#104;&#101; &#99;&#111;&#100;&#101; &#111;&#98;&#106;&#101;&#99;&#116;
-        &#111;&#102; &#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101; &#111;&#98;&#106;&#101;&#99;&#116; &#105;&#115; &#116;&#104;&#101; &#102;&#117;&#108;&#108;y &#113;&#117;&#97;&#108;&#105;&#102;&#105;&#101;&#100; &#102;&#105;&#108;&#101;&#112;&#97;&#116;&#104; w&#104;&#101;&#110; &#116;&#104;&#101;
-        &#112;y&#99; &#105;&#115; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101;&#100;. &#73;&#102; &#102;&#105;&#108;&#101;&#115; &#97;&#114;&#101; &#109;&#111;v&#101;&#100; &#102;&#114;&#111;&#109; &#109;&#97;&#99;&#104;&#105;&#110;&#101; &#116;&#111; &#109;&#97;&#99;&#104;&#105;&#110;&#101;
-        &#116;&#104;&#105;&#115; &#99;&#97;&#110; &#98;&#114;&#101;&#97;&#107; &#100;&#101;&#98;&#117;&#103;&#103;&#105;&#110;&#103; &#97;&#115; &#116;&#104;&#101; .&#112;y&#99; w&#105;&#108;&#108; &#114;&#101;&#102;&#101;&#114; &#116;&#111; &#116;&#104;&#101; .&#112;y
-        &#111;&#110; &#116;&#104;&#101; &#111;&#114;&#105;&#103;&#105;&#110;&#97;&#108; &#109;&#97;&#99;&#104;&#105;&#110;&#101;. &#65;&#110;&#111;&#116;&#104;&#101;&#114; &#99;&#97;&#115;&#101; &#109;&#105;&#103;&#104;&#116; &#98;&#101; &#115;&#104;&#97;&#114;&#105;&#110;&#103;
-        &#99;&#111;&#100;&#101; &#111;v&#101;&#114; &#97; &#110;&#101;&#116;w&#111;&#114;&#107;... &#84;&#104;&#105;&#115; &#108;&#111;&#103;&#105;&#99; &#100;&#101;&#97;&#108;&#115; w&#105;&#116;&#104; &#116;&#104;&#97;&#116;.
+        The logic employed here is that if a module was loaded
+        from a .pyc file, then the correct .py to operate with
+        should be in the same path as the .pyc. The reason this
+        logic is needed is that when a .pyc file is generated, the
+        filename embedded and thus what is readable in the code object
+        of the frame object is the fully qualified filepath when the
+        pyc is generated. If files are moved from machine to machine
+        this can break debugging as the .pyc will refer to the .py
+        on the original machine. Another case might be sharing
+        code over a network... This logic deals with that.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101; &#111;&#98;&#106;&#101;&#99;&#116;
+the frame object
 </dd>
 </dl><a NAME="DebugBase.getCurrentFrame" ID="DebugBase.getCurrentFrame"></a>
 <h4>DebugBase.getCurrentFrame</h4>
 <b>getCurrentFrame</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#102;&#114;&#97;&#109;&#101;.
+        Public method to return the current frame.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#116;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#102;&#114;&#97;&#109;&#101;
+the current frame
 </dd>
 </dl><a NAME="DebugBase.getEvent" ID="DebugBase.getEvent"></a>
 <h4>DebugBase.getEvent</h4>
 <b>getEvent</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#108;&#97;&#115;&#116; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#101;v&#101;&#110;&#116;.
+        Public method to return the last debugger event.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#108;&#97;&#115;&#116; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#101;v&#101;&#110;&#116; (&#115;&#116;&#114;&#105;&#110;&#103;)
+last debugger event (string)
 </dd>
 </dl><a NAME="DebugBase.getStack" ID="DebugBase.getStack"></a>
 <h4>DebugBase.getStack</h4>
 <b>getStack</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#116;&#104;&#101; &#115;&#116;&#97;&#99;&#107;.
+        Public method to get the stack.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#108;&#105;&#115;&#116; &#111;&#102; &#108;&#105;&#115;&#116;&#115; w&#105;&#116;&#104; &#102;&#105;&#108;&#101; &#110;&#97;&#109;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;), &#108;&#105;&#110;&#101; &#110;&#117;&#109;&#98;&#101;&#114; (&#105;&#110;&#116;&#101;&#103;&#101;&#114;)
-            &#97;&#110;&#100; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110; &#110;&#97;&#109;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;)
+list of lists with file name (string), line number (integer)
+            and function name (string)
 </dd>
 </dl><a NAME="DebugBase.get_break" ID="DebugBase.get_break"></a>
 <h4>DebugBase.get_break</h4>
 <b>get_break</b>(<i>filename, lineno</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#103;&#101;&#116; &#116;&#104;&#101; &#102;&#105;&#114;&#115;&#116; &#98;&#114;&#101;&#97;&#107;&#112;&#111;&#105;&#110;&#116; &#111;&#102; &#97; &#112;&#97;&#114;&#116;&#105;&#99;&#117;&#108;&#97;&#114; &#108;&#105;&#110;&#101;.
+        Reimplemented from bdb.py to get the first breakpoint of a particular line.
 </p><p>
-        &#66;&#101;&#99;&#97;&#117;&#115;&#101; &#101;&#114;&#105;&#99;&#53; &#115;&#117;&#112;&#112;&#111;&#114;&#116;&#115; &#111;&#110;&#108;y &#111;&#110;&#101; &#98;&#114;&#101;&#97;&#107;&#112;&#111;&#105;&#110;&#116; &#112;&#101;&#114; &#108;&#105;&#110;&#101;, &#116;&#104;&#105;&#115; &#111;v&#101;&#114;w&#114;&#105;&#116;&#116;&#101;&#110;
-        &#109;&#101;&#116;&#104;&#111;&#100; w&#105;&#108;&#108; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#105;&#115; &#111;&#110;&#101; &#97;&#110;&#100; &#111;&#110;&#108;y &#98;&#114;&#101;&#97;&#107;&#112;&#111;&#105;&#110;&#116;.
+        Because eric5 supports only one breakpoint per line, this overwritten
+        method will return this one and only breakpoint.
 </p><dl>
 <dt><i>filename</i></dt>
 <dd>
-&#116;&#104;&#101; &#102;&#105;&#108;&#101;&#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#98;&#112; &#116;&#111; &#114;&#101;&#116;&#114;&#105;&#101;v&#101; (&#115;&#116;&#114;&#105;&#110;&#103;)
+the filename of the bp to retrieve (string)
 </dd><dt><i>lineno</i></dt>
 <dd>
-&#116;&#104;&#101; &#108;&#105;&#110;&#101;&#110;&#117;&#109;&#98;&#101;&#114; &#111;&#102; &#116;&#104;&#101; &#98;&#112; &#116;&#111; &#114;&#101;&#116;&#114;&#105;&#101;v&#101; (&#105;&#110;&#116;&#101;&#103;&#101;&#114;)
+the linenumber of the bp to retrieve (integer)
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#98;&#114;&#101;&#97;&#107;&#112;&#111;&#105;&#110;&#116; &#111;&#114; &#78;&#111;&#110;&#101;, &#105;&#102; &#116;&#104;&#101;&#114;&#101; &#105;&#115; &#110;&#111; &#98;&#112;
+breakpoint or None, if there is no bp
 </dd>
 </dl><a NAME="DebugBase.get_watch" ID="DebugBase.get_watch"></a>
 <h4>DebugBase.get_watch</h4>
 <b>get_watch</b>(<i>cond</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#97; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110;.
+        Public method to get a watch expression.
 </p><dl>
 <dt><i>cond</i></dt>
 <dd>
-&#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; &#111;&#102; &#116;&#104;&#101; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; &#116;&#111; &#98;&#101; &#99;&#108;&#101;&#97;&#114;&#101;&#100; (&#115;&#116;&#114;&#105;&#110;&#103;)
+expression of the watch expression to be cleared (string)
 </dd>
 </dl><a NAME="DebugBase.go" ID="DebugBase.go"></a>
 <h4>DebugBase.go</h4>
 <b>go</b>(<i>special</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#115;&#117;&#109;&#101; &#116;&#104;&#101; &#116;&#104;&#114;&#101;&#97;&#100;.
+        Public method to resume the thread.
 </p><p>
-        &#73;&#116; &#114;&#101;&#115;&#117;&#109;&#101;&#115; &#116;&#104;&#101; &#116;&#104;&#114;&#101;&#97;&#100; &#115;&#116;&#111;&#112;&#112;&#105;&#110;&#103; &#111;&#110;&#108;y &#97;&#116; &#98;&#114;&#101;&#97;&#107;&#112;&#111;&#105;&#110;&#116;&#115; &#111;&#114; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110;&#115;.
+        It resumes the thread stopping only at breakpoints or exceptions.
 </p><dl>
 <dt><i>special</i></dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#97; &#115;&#112;&#101;&#99;&#105;&#97;&#108; &#99;&#111;&#110;&#116;&#105;&#110;&#117;&#101; &#111;&#112;&#101;&#114;&#97;&#116;&#105;&#111;&#110;
+flag indicating a special continue operation
 </dd>
 </dl><a NAME="DebugBase.isBroken" ID="DebugBase.isBroken"></a>
 <h4>DebugBase.isBroken</h4>
 <b>isBroken</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#98;&#114;&#111;&#107;&#101;&#110; &#115;&#116;&#97;&#116;&#101; &#111;&#102; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114;.
+        Public method to return the broken state of the debugger.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#98;&#114;&#111;&#107;&#101;&#110; &#115;&#116;&#97;&#116;&#101; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating the broken state (boolean)
 </dd>
 </dl><a NAME="DebugBase.profile" ID="DebugBase.profile"></a>
 <h4>DebugBase.profile</h4>
 <b>profile</b>(<i>frame, event, arg</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#117;&#115;&#101;&#100; &#116;&#111; &#116;&#114;&#97;&#99;&#101; &#115;&#111;&#109;&#101; &#115;&#116;&#117;&#102;&#102; &#105;&#110;&#100;&#101;&#112;&#101;&#110;&#100;&#97;&#110;&#116; &#111;&#102; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; 
-        &#116;&#114;&#97;&#99;&#101; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;.
+        Public method used to trace some stuff independant of the debugger 
+        trace function.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#84;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#115;&#116;&#97;&#99;&#107; &#102;&#114;&#97;&#109;&#101;.
+The current stack frame.
 </dd><dt><i>event</i></dt>
 <dd>
-&#84;&#104;&#101; &#116;&#114;&#97;&#99;&#101; &#101;v&#101;&#110;&#116; (&#115;&#116;&#114;&#105;&#110;&#103;)
+The trace event (string)
 </dd><dt><i>arg</i></dt>
 <dd>
-&#84;&#104;&#101; &#97;&#114;&#103;&#117;&#109;&#101;&#110;&#116;&#115;
+The arguments
 </dd>
 </dl><a NAME="DebugBase.setRecursionDepth" ID="DebugBase.setRecursionDepth"></a>
 <h4>DebugBase.setRecursionDepth</h4>
 <b>setRecursionDepth</b>(<i>frame</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#100;&#101;&#116;&#101;&#114;&#109;&#105;&#110;&#101; &#116;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#114;&#101;&#99;&#117;&#114;&#115;&#105;&#111;&#110; &#100;&#101;&#112;&#116;&#104;.
+        Public method to determine the current recursion depth.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#84;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#115;&#116;&#97;&#99;&#107; &#102;&#114;&#97;&#109;&#101;.
+The current stack frame.
 </dd>
 </dl><a NAME="DebugBase.set_continue" ID="DebugBase.set_continue"></a>
 <h4>DebugBase.set_continue</h4>
 <b>set_continue</b>(<i>special</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#97;&#108;w&#97;y&#115; &#103;&#101;&#116; &#105;&#110;&#102;&#111;&#114;&#109;&#101;&#100; &#111;&#102; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110;&#115;.
+        Reimplemented from bdb.py to always get informed of exceptions.
 </p><dl>
 <dt><i>special</i></dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#97; &#115;&#112;&#101;&#99;&#105;&#97;&#108; &#99;&#111;&#110;&#116;&#105;&#110;&#117;&#101; &#111;&#112;&#101;&#114;&#97;&#116;&#105;&#111;&#110;
+flag indicating a special continue operation
 </dd>
 </dl><a NAME="DebugBase.set_quit" ID="DebugBase.set_quit"></a>
 <h4>DebugBase.set_quit</h4>
 <b>set_quit</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#113;&#117;&#105;&#116;. 
+        Public method to quit. 
 </p><p>
-        &#73;&#116; w&#114;&#97;&#112;&#115; &#99;&#97;&#108;&#108; &#116;&#111; &#98;&#100;&#98; &#116;&#111; &#99;&#108;&#101;&#97;&#114; &#116;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#102;&#114;&#97;&#109;&#101; &#112;&#114;&#111;&#112;&#101;&#114;&#108;y.
+        It wraps call to bdb to clear the current frame properly.
 </p><a NAME="DebugBase.set_trace" ID="DebugBase.set_trace"></a>
 <h4>DebugBase.set_trace</h4>
 <b>set_trace</b>(<i>frame = None</i>)
 <p>
-        &#79;v&#101;&#114;&#114;&#105;&#100;&#100;&#101;&#110; &#109;&#101;&#116;&#104;&#111;&#100; &#111;&#102; &#98;&#100;&#98;.&#112;y &#116;&#111; &#100;&#111; &#115;&#111;&#109;&#101; &#115;&#112;&#101;&#99;&#105;&#97;&#108; &#115;&#101;&#116;&#117;&#112;.
+        Overridden method of bdb.py to do some special setup.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#102;&#114;&#97;&#109;&#101; &#116;&#111; &#115;&#116;&#97;&#114;&#116; &#100;&#101;&#98;&#117;&#103;&#103;&#105;&#110;&#103; &#102;&#114;&#111;&#109;
+frame to start debugging from
 </dd>
 </dl><a NAME="DebugBase.set_watch" ID="DebugBase.set_watch"></a>
 <h4>DebugBase.set_watch</h4>
 <b>set_watch</b>(<i>cond, temporary = False</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#101;&#116; &#97; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110;.
+        Public method to set a watch expression.
 </p><dl>
 <dt><i>cond</i></dt>
 <dd>
-&#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; &#111;&#102; &#116;&#104;&#101; w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; (&#115;&#116;&#114;&#105;&#110;&#103;)
+expression of the watch expression (string)
 </dd><dt><i>temporary</i></dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#97; &#116;&#101;&#109;&#112;&#111;&#114;&#97;&#114;y w&#97;&#116;&#99;&#104; &#101;x&#112;&#114;&#101;&#115;&#115;&#105;&#111;&#110; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating a temporary watch expression (boolean)
 </dd>
 </dl><a NAME="DebugBase.step" ID="DebugBase.step"></a>
 <h4>DebugBase.step</h4>
 <b>step</b>(<i>traceMode</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#112;&#101;&#114;&#102;&#111;&#114;&#109; &#97; &#115;&#116;&#101;&#112; &#111;&#112;&#101;&#114;&#97;&#116;&#105;&#111;&#110; &#105;&#110; &#116;&#104;&#105;&#115; &#116;&#104;&#114;&#101;&#97;&#100;.
+        Public method to perform a step operation in this thread.
 </p><dl>
 <dt><i>traceMode</i></dt>
 <dd>
-&#73;&#102; &#105;&#116; &#105;&#115; &#84;&#114;&#117;&#101;, &#116;&#104;&#101;&#110; &#116;&#104;&#101; &#115;&#116;&#101;&#112; &#105;&#115; &#97; &#115;&#116;&#101;&#112; &#105;&#110;&#116;&#111;,
-              &#111;&#116;&#104;&#101;&#114;w&#105;&#115;&#101; &#105;&#116; &#105;&#115; &#97; &#115;&#116;&#101;&#112; &#111;v&#101;&#114;.
+If it is True, then the step is a step into,
+              otherwise it is a step over.
 </dd>
 </dl><a NAME="DebugBase.stepOut" ID="DebugBase.stepOut"></a>
 <h4>DebugBase.stepOut</h4>
 <b>stepOut</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#112;&#101;&#114;&#102;&#111;&#114;&#109; &#97; &#115;&#116;&#101;&#112; &#111;&#117;&#116; &#111;&#102; &#116;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#99;&#97;&#108;&#108;.
+        Public method to perform a step out of the current call.
 </p><a NAME="DebugBase.stop_here" ID="DebugBase.stop_here"></a>
 <h4>DebugBase.stop_here</h4>
 <b>stop_here</b>(<i>frame</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#116;&#111; &#102;&#105;&#108;&#116;&#101;&#114; &#111;&#117;&#116; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#102;&#105;&#108;&#101;&#115;.
+        Reimplemented to filter out debugger files.
 </p><p>
-        &#84;&#114;&#97;&#99;&#105;&#110;&#103; &#105;&#115; &#116;&#117;&#114;&#110;&#101;&#100; &#111;&#102;&#102; &#102;&#111;&#114; &#102;&#105;&#108;&#101;&#115; &#116;&#104;&#97;&#116; &#97;&#114;&#101; &#112;&#97;&#114;&#116; &#111;&#102; &#116;&#104;&#101;
-        &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#116;&#104;&#97;&#116; &#97;&#114;&#101; &#99;&#97;&#108;&#108;&#101;&#100; &#102;&#114;&#111;&#109; &#116;&#104;&#101; &#97;&#112;&#112;&#108;&#105;&#99;&#97;&#116;&#105;&#111;&#110; &#98;&#101;&#105;&#110;&#103; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#100;.
+        Tracing is turned off for files that are part of the
+        debugger that are called from the application being debugged.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101; &#111;&#98;&#106;&#101;&#99;&#116;
+the frame object
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; w&#104;&#101;&#116;&#104;&#101;&#114; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103;&#103;&#101;&#114; &#115;&#104;&#111;&#117;&#108;&#100; &#115;&#116;&#111;&#112; &#104;&#101;&#114;&#101;
+flag indicating whether the debugger should stop here
 </dd>
 </dl><a NAME="DebugBase.trace_dispatch" ID="DebugBase.trace_dispatch"></a>
 <h4>DebugBase.trace_dispatch</h4>
 <b>trace_dispatch</b>(<i>frame, event, arg</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#102;&#114;&#111;&#109; &#98;&#100;&#98;.&#112;y &#116;&#111; &#100;&#111; &#115;&#111;&#109;&#101; &#115;&#112;&#101;&#99;&#105;&#97;&#108; &#116;&#104;&#105;&#110;&#103;&#115;.
+        Reimplemented from bdb.py to do some special things.
 </p><p>
-        &#84;&#104;&#105;&#115; &#115;&#112;&#101;&#99;&#105;&#97;&#108;&#116;y &#105;&#115; &#116;&#111; &#99;&#104;&#101;&#99;&#107; &#116;&#104;&#101; &#99;&#111;&#110;&#110;&#101;&#99;&#116;&#105;&#111;&#110; &#116;&#111; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103; &#115;&#101;&#114;v&#101;&#114;
-        &#102;&#111;&#114; &#110;&#101;w &#101;v&#101;&#110;&#116;&#115; (&#105;.&#101;. &#110;&#101;w &#98;&#114;&#101;&#97;&#107;&#112;&#111;&#105;&#110;&#116;&#115;) w&#104;&#105;&#108;&#101; w&#101; &#97;&#114;&#101; &#103;&#111;&#105;&#110;&#103; &#116;&#104;&#114;&#111;&#117;&#103;&#104;
-        &#116;&#104;&#101; &#99;&#111;&#100;&#101;.
+        This specialty is to check the connection to the debug server
+        for new events (i.e. new breakpoints) while we are going through
+        the code.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#84;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116; &#115;&#116;&#97;&#99;&#107; &#102;&#114;&#97;&#109;&#101;.
+The current stack frame.
 </dd><dt><i>event</i></dt>
 <dd>
-&#84;&#104;&#101; &#116;&#114;&#97;&#99;&#101; &#101;v&#101;&#110;&#116; (&#115;&#116;&#114;&#105;&#110;&#103;)
+The trace event (string)
 </dd><dt><i>arg</i></dt>
 <dd>
-&#84;&#104;&#101; &#97;&#114;&#103;&#117;&#109;&#101;&#110;&#116;&#115;
+The arguments
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#108;&#111;&#99;&#97;&#108; &#116;&#114;&#97;&#99;&#101; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;
+local trace function
 </dd>
 </dl><a NAME="DebugBase.user_exception" ID="DebugBase.user_exception"></a>
 <h4>DebugBase.user_exception</h4>
 <b>user_exception</b>(<i>frame, excinfo, unhandled = False</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#116;&#111; &#114;&#101;&#112;&#111;&#114;&#116; &#97;&#110; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110; &#116;&#111; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103; &#115;&#101;&#114;v&#101;&#114;.
+        Reimplemented to report an exception to the debug server.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101; &#111;&#98;&#106;&#101;&#99;&#116;
+the frame object
 </dd><dt><i>excinfo</i></dt>
 <dd>
-&#105;&#110;&#102;&#111;&#114;&#109;&#97;&#116;&#105;&#111;&#110; &#97;&#98;&#111;&#117;&#116; &#116;&#104;&#101; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110;
+information about the exception
 </dd><dt><i>unhandled</i></dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#97;&#110; &#117;&#110;&#99;&#97;&#117;&#103;&#104;&#116; &#101;x&#99;&#101;&#112;&#116;&#105;&#111;&#110;
+flag indicating an uncaught exception
 </dd>
 </dl><a NAME="DebugBase.user_line" ID="DebugBase.user_line"></a>
 <h4>DebugBase.user_line</h4>
 <b>user_line</b>(<i>frame</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#116;&#111; &#104;&#97;&#110;&#100;&#108;&#101; &#116;&#104;&#101; &#112;&#114;&#111;&#103;&#114;&#97;&#109; &#97;&#98;&#111;&#117;&#116; &#116;&#111; &#101;x&#101;&#99;&#117;&#116;&#101; &#97; &#112;&#97;&#114;&#116;&#105;&#99;&#117;&#108;&#97;&#114; &#108;&#105;&#110;&#101;.
+        Reimplemented to handle the program about to execute a particular line.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101; &#111;&#98;&#106;&#101;&#99;&#116;
+the frame object
 </dd>
 </dl><a NAME="DebugBase.user_return" ID="DebugBase.user_return"></a>
 <h4>DebugBase.user_return</h4>
 <b>user_return</b>(<i>frame, retval</i>)
 <p>
-        &#82;&#101;&#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#101;&#100; &#116;&#111; &#114;&#101;&#112;&#111;&#114;&#116; &#112;&#114;&#111;&#103;&#114;&#97;&#109; &#116;&#101;&#114;&#109;&#105;&#110;&#97;&#116;&#105;&#111;&#110; &#116;&#111; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103; &#115;&#101;&#114;v&#101;&#114;.
+        Reimplemented to report program termination to the debug server.
 </p><dl>
 <dt><i>frame</i></dt>
 <dd>
-&#116;&#104;&#101; &#102;&#114;&#97;&#109;&#101; &#111;&#98;&#106;&#101;&#99;&#116;
+the frame object
 </dd><dt><i>retval</i></dt>
 <dd>
-&#116;&#104;&#101; &#114;&#101;&#116;&#117;&#114;&#110; v&#97;&#108;&#117;&#101; &#111;&#102; &#116;&#104;&#101; &#112;&#114;&#111;&#103;&#114;&#97;&#109;
+the return value of the program
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
@@ -636,11 +636,11 @@
 <h2>printerr</h2>
 <b>printerr</b>(<i>s</i>)
 <p>
-    &#77;&#111;&#100;&#117;&#108;&#101; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110; &#117;&#115;&#101;&#100; &#102;&#111;&#114; &#100;&#101;&#98;&#117;&#103;&#103;&#105;&#110;&#103; &#116;&#104;&#101; &#100;&#101;&#98;&#117;&#103; &#99;&#108;&#105;&#101;&#110;&#116;.
+    Module function used for debugging the debug client.
 </p><dl>
 <dt><i>s</i></dt>
 <dd>
-&#100;&#97;&#116;&#97; &#116;&#111; &#98;&#101; &#112;&#114;&#105;&#110;&#116;&#101;&#100;
+data to be printed
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
@@ -649,11 +649,11 @@
 <h2>setRecursionLimit</h2>
 <b>setRecursionLimit</b>(<i>limit</i>)
 <p>
-    &#77;&#111;&#100;&#117;&#108;&#101; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110; &#116;&#111; &#115;&#101;&#116; &#116;&#104;&#101; &#114;&#101;&#99;&#117;&#114;&#115;&#105;&#111;&#110; &#108;&#105;&#109;&#105;&#116;.
+    Module function to set the recursion limit.
 </p><dl>
 <dt><i>limit</i></dt>
 <dd>
-&#114;&#101;&#99;&#117;&#114;&#115;&#105;&#111;&#110; &#108;&#105;&#109;&#105;&#116; (&#105;&#110;&#116;&#101;&#103;&#101;&#114;)
+recursion limit (integer)
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>