% -*- texinfo -*-
% @deftypefn{Function File}{[@var{y},@var{numit},@var{resnrm}] =} @
% NLSnewtonraphson @
% (@var{y0}, @var{RES}, @var{JAC}, @var{tol}, @
% @var{maxit},@var{verbosity}, @var{update});
%
% Solves a non-linear system of equations using the Newton-Raphson
% method with damping.
%
% Input:
% @itemize @minus
% @item @var{y0}: initial guess
% @item @var{RES}: function handle to compute the residual
% @item @var{JAC} function handle to compute the jacobian
% @item @var{tol}: tolerance for convergence check
% @item @var{maxit}: maximum number of iterations
% @item @var{verbosity}: verbosity level
% @item @var{update}: update function to run at each timestep
% @end itemize
%
% Output:
% @itemize @minus
% @item @var{y}: initial guess
% @item @var{numit}: number of iterations performed
% @item @var{resnrm}: residual norm at each step
% @end itemize
% @seealso{NLSstationary, TSTbweuler, TSTdaspk}
% @end deftypefn