| DEFUN_DLD (givens, args, nargout,"-*- texinfo -*-\n\
@deftypefn {Loadable Function} {@var{g} =} givens (@var{x}, @var{y})\n\
@deftypefnx {Loadable Function} {[@var{c}, @var{s}] =} givens (@var{x}, @var{y})\n\
@tex\n\
Return a $2\\times 2$ orthogonal matrix\n\
$$\n\
G = \\left[\\matrix{c & s\\cr -s'& c\\cr}\\right]\n\
$$\n\
such that\n\
$$\n\
G \\left[\\matrix{x\\cr y}\\right] = \\left[\\matrix{\\ast\\cr 0}\\right]\n\
$$\n\
with $x$ and $y$ scalars.\n\
@end tex\n\
@ifnottex\n\
Return a 2 by 2 orthogonal matrix\n\
@code{@var{g} = [@var{c} @var{s}; -@var{s}' @var{c}]} such that\n\
@code{@var{g} [@var{x}; @var{y}] = [*; 0]} with @var{x} and @var{y} scalars.\n\
@end ifnottex\n\
\n\
For example:\n\
\n\
@example\n\
@group\n\
givens (1, 1)\n\
@result{} 0.70711 0.70711\n\
-0.70711 0.70711\n\
@end group\n\
@end example\n\
@end deftypefn") |