QNRES package - release 1.1.1 at June 6, 2006

Description of the package:
---------------------------

The QNRES package consists of the files listed and briefly described
below:

filename        contents of file

qnres.c         qnres main routine and some qnres specific internal routines.

utils.c         Common used utility routines by the NewtonLib codes:
                Dynamic memory allocation, computation of scalar products
                and norms, scaling and descaling of vectors, data output,
                parameter check and printout.
                
nleq.h          Common used type and macro definitions by the NewtonLib codes.
                Should also be included in main programs which call
                NewtonLib routines.

jacobian_and_linalg.c  Jacobian and linear algebra dependent routines.

jacobian.h      Type definition of the Jacobian - included via file nleq.h.

test_qnres.c    An example main program illustrating the usage of qnres.

lapack_and_blas.f  A selection of subroutines from LAPACK and BLAS, which
                   are needed by the NewtonLib codes.

makefile        An input file to the UNIX make utility containing informa-
                tion how to build the executable program test_qnres.

readme           This information.

qnres_out.nrm   Example monitor output of program run of test_qnres.

qnres_dat.nrm   Example data output of program run of test_qnres.


The main program solves a test problem (the Rosenbrock problem, with a
modified start point). To build the executable program, you need to 
compile and to link the files below:

test_qnres.c, qnres.c, utils.c, jacobian_and_linalg.c, lapack_and_blas.f

Under MacOSX (Darwin), SunOS, or Linux, simply type in:
make             -   to build program test_qnres.

Note that a few adaptations may be necessary to utilize the code for
your computer at hand. Please examine the nleq.h header file and adapt
the definitions of the macros SMALL and EPMACH, if needed.

If you wish to link other linear algebra routines than DGETRF and DGETRS
of LAPACK, then review the files jacobian_and_linalg.c and jacobian.h
and make the appropriate changes in these files.

Changes from Version 1.1 to 1.1.1:
----------------------------------

Missing int return code in function qnr_initscale, bug fixed.

Changes from Version 1.0 to 1.1:
--------------------------------

Added the output data files iterfile, resfile and miscfile,
where optional data output is provided, a single line, starting
with the iteration number, for each iteration step. These data
are suitable for graphical display by the GNUPLOT program.