% -*- texinfo -*-
% @deftypefn {Function File} {} eyediagram (@var{x},@var{n})
% @deftypefnx {Function File} {} eyediagram (@var{x},@var{n},@var{per})
% @deftypefnx {Function File} {} eyediagram (@var{x},@var{n},@var{per},@var{off})
% @deftypefnx {Function File} {} eyediagram (@var{x},@var{n},@var{per},@var{off},@var{str})
% @deftypefnx {Function File} {} eyediagram (@var{x},@var{n},@var{per},@var{off},@var{str},@var{h})
% @deftypefnx {Function File} {@var{h} =} eyediagram (@var{...})
%
% Plot the eye-diagram of a signal. The signal @var{x} can be either in one
% of three forms
%
% @table @asis
% @item A real vector
% In this case the signal is assumed to be real and represented by the vector
% @var{x}. A single eye-diagram representing this signal is plotted.
% @item A complex vector
% In this case the in-phase and quadrature components of the signal are
% plotted seperately.
% @item A matrix with two columns
% In this case the first column represents the in-phase and the second the
% quadrature components of a complex signal.
% @end table
%
% Each line of the eye-diagram has @var{n} elements and the period is assumed
% to be given by @var{per}. The time axis is then [-@var{per}/2 @var{per}/2].
% By default @var{per} is 1.
%
% By default the signal is assumed to start at -@var{per}/2. This can be
% overridden by the @var{off} variable, which gives the number of samples
% to delay the signal.
%
% The string @var{str} is a plot style string (example 'r+'),
% and by default is the default gnuplot line style.
%
% The figure handle to use can be defined by @var{h}. If @var{h} is not
% given, then the next available figure handle is used. The figure handle
% used in returned on @var{hout}.
% @end deftypefn
% @seealso{scatterplot}