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  * cad3d turns .3d files into various formats, but Aven's "Export" function
  19    can do almost everything cad3d can, plus some extra formats.  The main
  20    benefit of cad3d is that it can be easily used in scripts.
  21
  22  * cavern processes survey data, but since version 1.2.3 you can process .svx
  23    files by simply opening them with Aven.app, so you no longer need to run
  24    cavern from the command line.  As with cad3d, the main reason to run cavern
  25    directly is for use in scripts.
  26
  27  * 3dtopos converts a .3d file to a .pos file.  In Survex 1.2.19 and later,
  28    aven can export .pos files, so the main benefit of 3dtopos is that it can
  29    be easily used in scripts.
  30
  31  * diffpos compares the positions of stations in two .3d, .pos, etc files.
  32
  33  * sorterr sorts a .err file by a specified field.
  34
  35  * dump3d dumps out a list of the items in a .3d file - it's mainly useful for
  36    debugging.
  37
  38 Known shortcomings specific to the Mac OS X version of Survex
  39 =============================================================
  40
  41 These could be reproduced with Survex 1.2.19 when built using wxWidgets 3.0.2:
  42
  43  * On OS X, usually you can push the mouse pointer against the top of the
  44    screen to get the menu bar to appear, but this doesn't seem to work for
  45    aven.  As a workaround, aven detects if you're trying to do this and
  46    drops out of full-screen mode, which isn't perfect but beats being stuck
  47    in full screen mode.