.HD STOP stop
.SH NAME
stop \- set a breakpoint
.SH SYNOPSIS
.CS int stop()
.PP
.CS int stop(line_number)
.CS int line_number ;
.PP
.CS int stop(function)
.CS void (*func)() ;
.PP
.CS int stop(filename, line_number)
.CS char *filename ;
.CS int line_number ;
.SH OPTIONS
.FS src_stop 3
.SH DESCRIPTION
.CO Stop
sets a breakpoint in user code.
When the breakpoint is encountered, execution is interrupted and
a break level is created.
.PP
If the argument is a line number, the breakpoint is set at
that line in the current file.
If the argument is a function,
the breakpoint is set on the first line of that function.
If a filename and line number are passed as arguments, the breakpoint
is set at that line in the specified file.  
.PP
If 
.CO stop
is called without an argument, it will immediately interrupt
execution and create a break level.
This allows the user to create conditional breakpoints by
combining
.CO stop
within other debugging commands, such as
.CO action
or 
.CO tagaction .
.SH OPTIONS
The 
.FL src_stop
option indicates how many lines are listed when execution is stopped.
The letter
.PC B
appears before the line at which the breakpoint is set.
.SH BUGS
.PP
.CO Stop
cannot set breakpoints in compiled code.
.SH SEE ALSO
status,
delete,
cont,
action,
tagaction