% -*- texinfo -*-
% @deftypefn {Function File} {[@var{num}, @var{rate}] = } symerr (@var{a},@var{b})
% @deftypefnx {Function File} {[@var{num}, @var{rate}] = } symerr (@var{...},@var{flag})
% @deftypefnx {Function File} {[@var{num}, @var{rate} @var{ind}] = } symerr (@var{...})
%
% Compares two matrices and returns the number of symbol errors and the
% symbol error rate. The variables @var{a} and @var{b} can be either:
%
% @table @asis
% @item Both matrices
% In this case both matrices must be the same size and then by default the
% the return values @var{num} and @var{rate} are the overall number of symbol
% errors and the overall symbol error rate.
% @item One column vector
% In this case the column vector is used for symbol error comparision
% column-wise with the matrix. The returned values @var{num} and @var{rate}
% are then row vectors containing the num of symbol errors and the symbol
% error rate for each of the column-wise comparisons. The number of rows in
% the matrix must be the same as the length of the column vector
% @item One row vector
% In this case the row vector is used for symbol error comparision row-wise
% with the matrix. The returned values @var{num} and @var{rate} are then
% column vectors containing the num of symbol errors and the symbol error rate
% for each of the row-wise comparisons. The number of columns in the matrix
% must be the same as the length of the row vector
% @end table
%
% This behaviour can be overridden with the variable @var{flag}. @var{flag}
% can take the value 'column-wise', 'row-wise' or 'overall'. A column-wise
% comparision is not possible with a row vector and visa-versa.
% @end deftypefn