%INSERT Add a debug point into MULTI(R).
% INSERT(id,ADDR,TYPE,TIMEOUT) places a debug point at the provided address
% of the processor. The id handle defines the processor that will receive
% the new debug point. The debug point location is defined by ADDR, the
% desired memory address. MULTI provides several types of debug points.
% Refer to the MULTI help documentation for information on their respective
% behavior. The following debug TYPE options are supported:
% 'break' - Breakpoint (default)
% 'watch' - Watch Point
% The TIMEOUT parameter defines how long to wait (in seconds) for the
% insert to complete. If this period is exceeded, the routine returns
% immediately with a timeout error. In general the action (insert) still
% occurs, but the timeout value gave insufficient time to verify the
% completion of the action.
% INSERT(id,ADDR) same as above, except the timeout value defaults to the
% timeout property specified by the id object. Use GET(id,'timeout') to
% examine this default timeout value.
% INSERT(id,FILE,LINE,TYPE,TIMEOUT) places a debug point at the specified
% line in a source file of MULTI. The FILE parameter gives the name of the
% source file. LINE defines the line number to receive the breakpoint.
% MULTI provides several types of debug points. Refer to the previous list
% of supported debug point types. Refer to MULTI documentation for
% information on their respective behavior.
% INSERT(id,FILE,LINE) same as above, except the timeout value defaults to
% the timeout property specified by the id object. Use GET(id, 'timeout')
% to examine this default timeout value.
% See also GHSMULTI/REMOVE, GHSMULTI/ADDRESS, GHSMULTI/RUN.
% Copyright 2012 The MathWorks, Inc.