=begin
= paraxial optics calculations((-$Id: README,v 1.2 2004/10/28 07:24:11 tomono Exp $-))

== Usage
=== lenscalc
lenscalc [options] input_lens_file

This program calculates a paraxial optical system as specified in the
lens file with a certain number of lenses. Namely, it measures image
distance of the star and the pupil from the last surface, and spatial or
angular magnification for the star and the pupil.

options [defaults]:
* -o, --output=output_lens_file : output file [stdout]
* -i, --max-iteration=N : limits number of iterations [200]
* -t, --max-step-time=S : limits duration of an iteration step [10]
* -e, --absolute-epsilon=x : absolute epsilon [1e-10]

* -v, --verbose : increases verbosity
* -q, --quiet : decreases verbosity
* -h : shows short description
* -H, --help : shows long description
* -V, --version : thisplays the version

== Installation
=== Required packages
* GNU Scientific Library (GSL) ((<URL:http://www.gnu.org/software/gsl/>))

=== Configuration, compilation and installation 
Usually, you just have to do the following to compile.
  $ ./confiugre
  $ make

If everything goes good, install the programs as the root:
  # make install

If ./configure does not work, follow these steps before doing above:
  $ aclocal
  $ autoconf
  $ autoheader
  $ automake

You can also
  $ make check
to check if everything (hopefully) is working good.

== Todo's
* Constrain parameters
* Change of 'from' thicknesses in optimization

== Copyright

Copyright (C) 2003, 2004 Daigo Tomono <dtomono at freeshell.org>

Permission is granted copying, modification, distribution, and distribution
of modified versions of this work under the terms of GPL version 2 or later.

mallocprintf() routine in mallocprintf.c is taken from the man page of
printf(3) by Copyright (c) 1999 Andries Brouwer (aeb at cwi.nl) and revised
by jsm28 at hermes.cam.ac.uk, which is distributed under the terms of GPL
version 2 or later.

Read the COPYING file for more details.

=end
