documentation update

2 files changed, 86 insertions, 81 deletions

diff --git a/NEWS b/NEWS
index 13e9940..e021145 100644
--- a/NEWS
+++ b/NEWS
@@ -1,95 +1,100 @@
 gipfel ChangeLog
 =================
 
+gipfel-0.2.5
+* Improve stitching speed.
+* Fix a bug with tiff file generation in stitching mode.
+* Update README file.
+
 gipfel-0.2.4
- - Fix another issue in the rectilinear projection code
+* Fix another issue in the rectilinear projection code
    that affected non-horizontally shot pictures.
- - Use a more robust forumla for spherical distance computation.
- - Take refraction effect into account.
+* Use a more robust forumla for spherical distance computation.
+* Take refraction effect into account.
 
 gipfel-0.2.3
- - Fix a major shortcoming in the rectilinear projection
+* Fix a major shortcoming in the rectilinear projection
    code. This improves accuracy quite a bit, mostly in
    wideangle images.
 
 gipfel-0.2.2
- - Fix a segfault if exif tool is not installed.
- - Some optimizations.
- - Don't make view window larger than the screen.
- - Add command line oprtions for data export.
- - Add visibility command line option.
- - Reset known hills when loading new image.
- - Cancel "Choose Hill" dialog on Esc.
- - Make code -Wall clean.
+* Fix a segfault if exif tool is not installed.
+* Some optimizations.
+* Don't make view window larger than the screen.
+* Add command line oprtions for data export.
+* Add visibility command line option.
+* Reset known hills when loading new image.
+* Cancel "Choose Hill" dialog on Esc.
+* Make code*Wall clean.
 
 gipfel-0.2.1
- - Fix compilation problem.
- - Replace bilinear with bicubic interpolation in stitching mode (-b option).
- - Improve usability of "Choose Viewpoint" dialog.
+* Fix compilation problem.
+* Replace bilinear with bicubic interpolation in stitching mode (-b option).
+* Improve usability of "Choose Viewpoint" dialog.
    Up/Down/Return now do what one would expect.
- - Improve lens distortion correction.
+* Improve lens distortion correction.
    Horizontal main point offsets are taken into account now.
- - Ask before overwriting existing lens profiles.
- - Update alpinkoordinaten.dat datafile.
+* Ask before overwriting existing lens profiles.
+* Update alpinkoordinaten.dat datafile.
 
 gipfel-0.2.0
- - Change scale factor to "focal length in 35mm" this makes it 
+* Change scale factor to "focal length in 35mm" this makes it 
    independent of the image size. One can now scale an already 
    oriented image without invalidating the orientation information.
- - gipfel now tries to find a reasonable default for the scale value
+* gipfel now tries to find a reasonable default for the scale value
    when opening new images based on the "Focal Length In 35mm" Exif 
    tag, if it exists.
- - GPS Exif tags are used if they exist.
- - gipfel can now correct lens distortion (see README).
- - Switched to use maxima for symbolic computation and code generation.
- - Switched to use th GNU Scientific Library instead of ccmath.
- - Major simplifications of the projection code.
- - Removed the "guess" button.
- - Added bilinear interpolation for image stitching (-b option).
- - Added range option (-r) for image stitching.
- - Known mountains must now be marked with the middle mouse button
+* GPS Exif tags are used if they exist.
+* gipfel can now correct lens distortion (see README).
+* Switched to use maxima for symbolic computation and code generation.
+* Switched to use th GNU Scientific Library instead of ccmath.
+* Major simplifications of the projection code.
+* Removed the "guess" button.
+* Added bilinear interpolation for image stitching (-b option).
+* Added range option (-r) for image stitching.
+* Known mountains must now be marked with the middle mouse button
    and positioned by dragging them with the left button pressed.
 
 gipfel-0.1.3
- - Add stitching mode (gipfel -s). See README  for details.
- - Update datafile from http://www.alpin-koordinaten.de
- - Fix various bugs.
+* Add stitching mode (gipfel*s). See README  for details.
+* Update datafile from http://www.alpin-koordinaten.de
+* Fix various bugs.
 
 gipfel-0.1.2
- - Fix bugs for "Normal Projection" and "Panoramic Projection" mode.
+* Fix bugs for "Normal Projection" and "Panoramic Projection" mode.
    Panorama mode now works with the great view from Mount Everest by
    Roddy Mackenzie (google for mackenzie everest panorama).
- - Add variable width display of GPS tracks (depending on the distance).
- - Add heuristics for hidden object detection.
- - Switch to fltk "plastic" scheme as it looks better.
+* Add variable width display of GPS tracks (depending on the distance).
+* Add heuristics for hidden object detection.
+* Switch to fltk "plastic" scheme as it looks better.
 
 gipfel-0.1.1
- - Don't try to display invisible trackpoints.
- - Fix bug in "Normal Projection" code for wide angle images.
- - Avoid complete redraw when moving mountains to reduce flicker.
+* Don't try to display invisible trackpoints.
+* Fix bug in "Normal Projection" code for wide angle images.
+* Avoid complete redraw when moving mountains to reduce flicker.
 
 gipfel-0.1.0
- - Display of GPS-tracks.
+* Display of GPS-tracks.
    GPS-tracks e.g. those that can be downloaded from www.alpin-koordinaten.de
    ("Fugawi 3 TXT" format) or self-recored ones, can be projected 
    on your digital images!
- - Load/save perspective data from/to JPEG comment section.
+* Load/save perspective data from/to JPEG comment section.
    This means, that you can create and share "gipfel-enabled" images. 
    Whenever you want, you can use these images and e.g. display your 
    GPS-tracks on them, without further fiddling to find the view parameters.
- - Experimental support for panorama images.
+* Experimental support for panorama images.
    gipfel can now handle images with panoramic projection. Check the
    "Options" menu entry.
- - Data file from www.alpin-koordinaten.de
+* Data file from www.alpin-koordinaten.de
    With the kind permission of the guys from www.alpin-koordinaten.de, the
    gipfel tarball now contains a default datafile with more than 6000 entries
    from around the world.
- - Duplicate GPS entry elimation.
- - Show parameter values in control window.
+* Duplicate GPS entry elimation.
+* Show parameter values in control window.
    No need to choose your viewpoint on the commandline. Use the new 
    "peak-choosing" widget to find your viewpoint interactively.
- - Choose viewpoint via GUI.
- - Improved label placement.
+* Choose viewpoint via GUI.
+* Improved label placement.
 
 gipfel-0.0.1
- - Initial version.
+* Initial version.
diff --git a/README b/README
index 37e3b97..440cd94 100644
--- a/README
+++ b/README
@@ -30,7 +30,7 @@ Requirements
 
 Installation
 ------------
-* Unpack the tar file and run `./configure; make; make install`
+Unpack the tar file and run `./configure; make; make install`
 
 Running
 -------
@@ -132,38 +132,6 @@ taken into account according to the approximation described by Tom Chester in:
 under the assumption of a temperature change of 6.5°C per 1000m and a
 temperature T0 at view point level of 10°C.
 
-Stitching
----------
-If you have multiple images from the same viewpoint referenced with gipfel
-you can stitch them together to form a panorama image.
-For stitching the input images must all have been correctly referenced
-with gipfel and saved (see "Loading and Saving Images").
-You can then call
-	gipfel -s <img1> <img2> ...
-to see the result in a window. Alternatively you can call
-	gipfel -s -j <outimg> <img1> <img2> ...
-to save the result as a JPEG image to <outimg> or 
-	gipfel -s -t <outdir> <img1> <img2> ...
-to save the result as multiple TIFF images to <outdir>.
-Use the multiple TIFF option for blending the result with enblend
-<http://enblend.sourceforge.net/>.
-The width and height of the result images can be adjusted with the
--w and -h options.
-You can use the -b switch to enable bicubic interpolation, which 
-gives smoother results but is a bit slower.
-
-The nice thing about stitching is that gipfel uses the same code that
-it already had for positioning mountains on the pictures.
-gipfel simply scans all directions needed for the panorama and determines
-where these directions would end up on the various pictures. It can then
-record the corresponding color values from the input images.
-
-In contrast to other stitching programs, the input images don't need to 
-overlap.
-
-If you want to open a stitched image in gipfel to locate the mountains
-on it, don't forget to choose Panoramic Projection!
-
 Exif Data
 ---------
 gipfel tries to get useful information from the exif data of the
@@ -195,6 +163,38 @@ Independent of the distortion profiles one can also modify the
 distortion parameters per image.
 Distortion correction is also used when stitching panorama images.
 
+Stitching Panorama Images
+-------------------------
+If you have multiple images from the same viewpoint referenced with gipfel
+you can stitch them together to form a panorama image.
+For stitching the input images must all have been correctly referenced
+with gipfel and saved (see "Loading and Saving Images").
+You can then call
+        gipfel -s <img1> <img2> ...
+to see the result in a window. Alternatively you can call
+        gipfel -s -j <outimg> <img1> <img2> ...
+to save the result as a JPEG image to <outimg> or
+        gipfel -s -t <outdir> <img1> <img2> ...
+to save the result as multiple TIFF images to directory <outdir>.
+Use the multiple TIFF option for blending the result with enblend
+<http://enblend.sourceforge.net/>.
+The width and height of the result images can be adjusted with the
+-w and -h options.
+You can use the -b switch to enable bicubic interpolation, which
+gives smoother results but is a bit slower.
+
+The nice thing about stitching is that gipfel uses the same code that
+it already had for positioning mountains on the pictures.
+gipfel simply scans all directions needed for the panorama and determines
+where these directions would end up on the various pictures. It can then
+record the corresponding color values from the input images.  
+
+In contrast to other stitching programs, the input images don't need to
+overlap.
+
+If you want to open a stitched image in gipfel to locate the mountains
+on it, don't forget to choose Panoramic Projection!
+
 Troubleshooting
 ---------------
 * Obviously gipfel can only be as good as its input data. If there is no