Debugging run-time errors in ado-files                          [ip7: STB-23]
--------------------------------------

                ^findbug^ [ ^-a^ ] any-Stata-command

Description
-----------

^findbug^ is a sophisticated replacement for the ^trace^ command.  ^findbug^ executes
the Stata command and keeps a trace of the execution in the file ^_findbug.log^
in the current directory.  If there is an error, ^findbug^ displays the line that
triggered the error along with several preceding and succeeding lines.  If the
^-a^ option is specified, ^findbug^ also lists the roster of ado-files called, from
the most recently called to the initial program invoked by the Stata command.  
These features make it easy to locate the source of a run-time error.

Option
------

^-a^ directs ^findbug^ to display an ordered list of ado-files called prior 
    to the error.  Normally ^findbug^ does not display this list.  ^findbug^
    runs somewhat faster when the ^-a^ option is not specified.


Author
------

        Timothy J. Schmidt
        Federal Reserve Bank of Kansas City
        FAX 816-881-2307


Also see
--------

 Manual:  [6a] pause, [6a] program
    STB:  ip7 (STB-23)
On-line:  ^help^ for @pause@ and @trace@