stairs

% -*- texinfo -*-
% @deftypefn {Function File} {} stairs (@var{x}, @var{y})
% @deftypefnx {Function File} {} stairs (@dots{}, @var{style})
% @deftypefnx {Function File} {} stairs (@dots{}, @var{prop}, @var{val})
% @deftypefnx {Function File} {} stairs (@var{h}, @dots{})
% @deftypefnx {Function File} {@var{h} =} stairs (@dots{})
% Produce a stairstep plot.  The arguments may be vectors or matrices.
%
% If only one argument is given, it is taken as a vector of y-values
% and the x coordinates are taken to be the indices of the elements.
%
% If two output arguments are specified, the data are generated but
% not plotted.  For example,
%
% @example
% stairs (x, y);
% @end example
%
% @noindent
% and
%
% @example
% @group
% [xs, ys] = stairs (x, y);
% plot (xs, ys);
% @end group
% @end example
%
% @noindent
% are equivalent.
% @seealso{plot, semilogx, semilogy, loglog, polar, mesh, contour,
% bar, xlabel, ylabel, title}
% @end deftypefn