lib/INSTALL.OSX

   1 Installing Survex on Mac OS X
   2 =============================
   3
   4 Next to the INSTALL file that you are currently reading is the Survex folder.
   5 To install, just drag this folder to your Applications folder (you will need to
   6 be logged in at an Administrator level to do this), or drag it to a folder
   7 under your home folder.
   8
   9 The programs alongside Aven.app need to be run from the command-line (open
  10 Terminal.app):
  11
  12  * extend produces extended elevations - this is probably the most useful of
  13    these command line tools.  Since version 1.2.27 you can produce simple
  14    extended elevations from Aven using the "Extended Elevation" function.
  15    However the command line tool allows you to specify a spec file to control
  16    how the survey is extended, which you can't currently do via Aven.
  17
  18  * cavern processes survey data, but since version 1.2.3 you can process .svx
  19    files by simply opening them with Aven.app, so you no longer need to run
  20    cavern from the command line.  The main reason to run cavern directly is for
  21    use in scripts.
  22
  23  * diffpos compares the positions of stations in two .3d, .pos, etc files.
  24
  25  * sorterr sorts a .err file by a specified field.
  26
  27  * survexport provides access to Aven's "Export" functionality from the command
  28    line which can be useful in scripts.
  29
  30  * dump3d dumps out a list of the items in a .3d file - it's mainly useful for
  31    debugging.
  32
  33 Known shortcomings specific to the Mac OS X version of Survex
  34 =============================================================
  35
  36 These could be reproduced with Survex 1.2.19 when built using wxWidgets 3.0.2:
  37
  38  * On OS X, usually you can push the mouse pointer against the top of the
  39    screen to get the menu bar to appear, but this doesn't seem to work for
  40    aven.  As a workaround, aven detects if you're trying to do this and
  41    drops out of full-screen mode, which isn't perfect but beats being stuck
  42    in full screen mode.