%DBSTOP Set breakpoint.
%   The DBSTOP command is used to temporarily stop the execution of an
%   M-file function and give the user an opportunity to examine the local
%   workspace.  Issuing a DBSTOP command is equivalent to editing the
%   M-file function and inserting a KEYBOARD command in front of the line
%   number specified.  There are seven forms to this command.  They are:
%
%   (1) DBSTOP IN MFILE AT LINENO
%   (2) DBSTOP IN MFILE AT SUBFUN
%   (3) DBSTOP IN MFILE
%   (4) DBSTOP IF ERROR
%   (5) DBSTOP IF ALL ERROR
%   (6) DBSTOP IF WARNING
%   (7) DBSTOP IF NANINF  or  DBSTOP IF INFNAN
%
%   where LINENO is a line number within M-file function MFILE.  MFILE
%   must be the name of an m-file function or a MATLABPATH relative
%   partial pathname (see PARTIALPATH).  The AT, IN and IF keywords
%   are optional.
%
%   The seven forms behave as follows:
%
%   (1) Stops at the specified line number in the function.
%   (2) Stops at the specified subfunction in the multi-function m-file.
%   (3) Stops at the first executable line in the function.
%   (4) Causes a stop in any M-file function causing a run-time error.
%       This does not include errors detected within a TRY...CATCH block.
%       You cannot resume M-file execution after a run-time error.
%   (5) Is the same as (4), except that it stops execution on any type
%       of run-time error, including errors that are detected within a 
%       TRY...CATCH block. 
%   (6) Causes a stop in any M-file function causing a run-time warning. 
%   (7) Causes a stop in any M-file function where an infinite value (Inf)
%       or Not-a-Number (NaN) is detected.
%
%   When MATLAB reaches a breakpoint, it enters debug mode.  The prompt
%   changes to a K>> and, on the PC, the debugger window becomes active.
%   Any MATLAB command is allowed at the prompt.  To resume M-file
%   function execution, use DBCONT or DBSTEP.  To exit from the debugger,
%   use DBQUIT.
%
%   See also DBCONT, DBSTEP, DBCLEAR, DBTYPE, DBSTACK, DBUP, DBDOWN,
%            DBSTATUS, DBQUIT, PARTIALPATH.

%   Steve Bangert, 6-25-91. Revised, 1-3-92.
%   Copyright 1984-2000 The MathWorks, Inc. 
%   $Revision: 5.17 $  $Date: 2000/08/22 13:35:32 $
%   Built-in function.
