%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 five forms to this command.  They are:
%
%   DBSTOP IN MFILE AT LINENO
%   DBSTOP IN MFILE AT SUBFUN
%   DBSTOP IN MFILE
%   DBSTOP IF ERROR
%   DBSTOP IF WARNING
%   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 first form stops at the specified line number in the function.
%   The second form stops at the specified subfunction in the
%      multi-function m-file.
%   The third form stops at the first executable line in the function.
%   The fourth form causes a stop in any M-file function causing a
%      run-time error. You cannot resume M-file execution after a
%      run-time error.
%   The fifth form causes a stop in any M-file function causing a
%      run-time warning. 
%   The sixth form causes a stop in any M-file function where an
%      infinite value (Inf) or Not-a-Number (NaN) is detected.
%
%   When a breakpoint is hit, MATLAB goes into debug mode.  On the PC
%   and Macintosh the debugger window becomes active and on UNIX and VMS
%   the prompt changes to a K>.  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 (c) 1984-98 by The MathWorks, Inc.
%   $Revision: 5.10 $  $Date: 1997/11/21 23:31:35 $
%   Built-in function.
