Installing Survex on Mac OS X
=============================

Next to the INSTALL file that you are currently reading is the Survex folder.
To install, just drag this folder to your Applications folder (you will need to
be logged in at an Administrator level to do this), or drag it to a folder
under your home folder.

The programs alongside Aven.app need to be run from the command-line (open
Terminal.app):

 * extend produces extended elevations - this is probably the most useful of
   these command line tools.

 * cad3d turns .3d files into various formats, but Aven's "Export" function
   can do almost everything cad3d can, plus some extra formats.  The main
   benefit of cad3d is that it can be easily used in scripts.

 * cavern processes survey data, but since version 1.2.3 you can process .svx
   files by simply opening them with Aven.app, so you no longer need to run
   cavern from the command line.  As with cad3d, the main reason to run cavern
   directly is for use in scripts.

 * 3dtopos converts a .3d file to a .pos file.  In Survex 1.2.19 and later,
   aven can export .pos files, so the main benefit of 3dtopos is that it can
   be easily used in scripts.

 * diffpos compares the positions of stations in two .3d, .pos, etc files.

 * sorterr sorts a .err file by a specified field.

 * dump3d dumps out a list of the items in a .3d file - it's mainly useful for
   debugging.

Known shortcomings specific to the Mac OS X version of Survex
=============================================================

These could be reproduced with Survex 1.2.19 when built using wxWidgets 3.0.2:

- On other platforms, pushing the pointer to the top of the screen when in full
  screen mode makes the menu bar appear.  This doesn't work on OS X, so instead
  aven will drop out of full screen mode in this case.