QNERR package - release 1.1.1 at June 6, 2006

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

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

filename        contents of file

qnerr.c         qnerr main routine and some qnerr 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_qnerr.c    An example main program illustrating the usage of qnerr.

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_qnerr.

readme           This information.

qnerr_out.nrm   Example monitor output of program run of test_qnerr.

qnerr_dat.nrm   Example data output of program run of test_qnerr.


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_qnerr.c, qnerr.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_qnerr.

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 qne_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.