Update for 1.2.25
[survex.git] / NEWS
blob93a42d699dc9ac488738836ae5d7600c10c6266c
1 Changes in 1.2.25 (2016-01-05):
3 * aven:
5   + Drop broken code which attempts to fix 2D pitches.  Fixes #73, reported by
6     Erin Lynch.  #76 tracks the issue the removed code was trying (but failing)
7     to address.
9   + When animating, don't try to update station info based on mouse movement
10     over the survey tree.
12   + Further improve code to handle cavern subprocess in aven.
14   + Fix jump to error for filenames containing colons when the error location
15     doesn't have a column number.  Bug noted by Jenny Black.
17   + If we encounter bad UTF-8 in cavern output, replace it with a red and white
18     ? in a diamond (previously we gave up showing output at the first bad
19     sequence).  This can happen if you process a .svx file which isn't UTF-8
20     encoded.
22   + (Unix version): Don't try to set the terminal window title when opening an
23     editor from the cavern log window - gnome-terminal no longer supports this,
24     and there doesn't seem to be a portable option for specifying the title for
25     terminals which do still support this.
27   + (Microsoft Windows version): Also quote for cmd.exe so that paths with
28     spaces in work reliably.  Reported by Marco Cotto.
30 * cavern:
32   + Improve error for mismatched fore/back-sight plumbs, reported by Andy
33     Edwards (see #78).
35   + Fix to use correct sd for backcompass.  We were using zero instead, the
36     most obvious effect of which was that the threshold for warning about
37     differing COMPASS and BACKCOMPASS was about 71% of what it should have
38     been, so we were warning in more cases than we should have been.
40   + Implement support for specifying a length on backsights - if you're using
41     something like a disto-x, you'll get a distance reading for the backsight
42     too.  Fixes #71, reported by Erin Lynch.
44   + Make line counting more robust to mixed line ends.  Noticed in example file
45     from Pete Smart (see #69).
47 * extend: New --show-breaks option which adds a leg flagged as surface survey
48   between each points at which a loop has been broken.  Suggested by Jenny
49   Black.
51 * (Unix version): Update filetype metadata to work with modern desktops.
53 * Fix incorrect reporting of errors reading and writing processed survey data.
54   Since 1.2.8, the error strings corresponding to IMG_CANTOPENOUT,
55   IMG_BADFORMAT and IMG_DIRECTORY have been mixed up (this doesn't affect
56   external programs using the img library, only Survex).  Reported by Jenny
57   Black.
59 * Add missing options to extend man page and --help output.  Noted by Jenny
60   Black.
62 * Document Document Ctrl+cursor keys for rotating and tilting in aven man page.
64 * Fix broken SGML markup in manual.
66 * Fix typo in manual reported by Jenny Black.
68 * Update vim syntax file for newer commands, etc.
70 * Minor translation updates.  Thanks to Piotr Strębski and Jean-Marc.
72 * Fix to compile with FFmpeg 2.9.  Reported by Andreas Cadhalpun in
73   https://bugs.debian.org/803863
75 * Stop maintaining ChangeLog files.  They make merging patches harder, and stop
76   'git cherry-pick' from working as it should.  The git repo history should be
77   sufficient for complying with GPLv2 2(a).
79 * (Microsoft Windows version): The installer requires admin privileges on Vista
80   and later and OS versions older than Vista are past end of life, so drop code
81   which tries to set up the registry differently depending if we have admin
82   privileges or not.
84 Changes in 1.2.24 (2015-09-23):
86 * aven:
88   + (Microsoft Windows version): Fix the cavern log window.  Reported by Brian
89     Clipstone.
91   + (Microsoft Windows version): Add workaround to avoid breakage in Therion.
92     Reported by Jenny Black.
94   + If wx was built with thread support, aven now runs cavern from a separate
95     thread, which works much better under wxMSW (where we can't use select),
96     and also seems a bit smoother on Linux.
98   + Fix handling of encoding of filenames when the operating system has no
99     locale installed corresponding to the language selected for Survex's
100     messages.
102   + Undo accidentally committed debugging code which was sending message to
103     the terminal in 1.2.23.
105 * (Linux version): configure now looks first for wx-config-3.0, which Fedora's
106   wx3 packages have.  Reported by James Begley.
108 * Indonesian translation fully up to date again.
110 * Manual: Document anonymous stations, based on the text from NEWS.  Reported
111   by Wookey.
113 Changes in 1.2.23 (2015-09-06):
115 * aven:
117   + Updating the cavern log window is now much smoother, especially on slower
118     machines.
120   + Show "busy" mouse cursor while processing survey data.
122   + Fix an assertion if you try to start processing a survex file while one is
123     already being processed.
125   + Processing a .svx file with an error now still adds it to the file history.
126     Reported by Martin Green.
128   + Fix the orientation of the starting end of tubes.
130 * cavern:
132   + New *ref command to allow specifying an external reference (e.g. where to
133     find the original survey notes).
135   + Drop support for showing percentage progress in cavern.  It's confusing in
136     a multiple-file dataset as it shows progress in the current file so jumps
137     around.  It also slows down processing, and on a slow machine you'd don't
138     want that, while on a fast machine processing isn't slow enough for the
139     progress display to be useful.
141 * French translation is now completely up to date, thanks to Michel Bovey.
143 * Bundle proj's EPSG and ESRI code lists in the installers for MS Windows and
144   OS X so that things like "*cs EPSG:29903" work.  Reported by Graham Mullan.
146 * (Microsoft Windows version): Process survey data with aven rather than
147   running cavern.
149 * (Microsoft Windows version): Installer built with InnoSetup 5.5.6 (recent
150   releases have been built with 5.5.3) to see if that solves Ray Duffy's
151   reported issue with not having file associations for .svx files created.
153 Changes in 1.2.22 (2015-08-17):
155 * aven:
157   + Ensure that the window has a depth buffer.  Whether it does by default
158     seems to vary depending on OS and maybe graphics card.  Fixes #55 (terrain
159     is no longer visible through itself), and also the rendering of passage
160     tubes.  Thanks to Martin Green for pointing me in the right direction for
161     finding this fix.
163 * cavern:
165   + Fix *declination with an angle to actually work.
167   + Fix assertion if we try to identify a hanging survey by an anonymous
168     station.
170   + Improve errors for invalid survey names in *begin, *end, *equate and
171     *export.
173 Changes in 1.2.21 (2015-07-28):
175 * aven:
177   + Fix exporting to KML and other text-based formats to always use "." for the
178     decimal separator - previously "," would be used when the user's locale
179     specified this for the decimal separator.  Reported by Jan Schorn.
181   + Implement exporting of survey legs in KML format.
183   + Put "paddle" placemarker icons on stations in exported KML files, using the
184     same colour coding for entrances, fixed points and exported points as aven
185     does.
187   + Remove the "Coordinate projection" field from the print dialog, as it isn't
188     relevant there.  Reported by Wookey.
190   + Fix the initial scale for small caves (since 1.2.18 the initial scale has
191     been too small).  Reported by Wookey.
193   + Don't rescale if the same file is reloaded, but adjust the volume diameter
194     as appropriate.
196   + Use wxGetenv() to read the SURVEXEDITOR variable, so we can accept Unicode
197     values on Windows.
199 * cavern:
201   + Fix coordinate systems using latitude and longitude - PROJ.4 wants these in
202     radians, but we were passing degrees, which would generally cause the
203     conversion to the output coordinate system to fail.  Reported by Wookey.
205   + Fix *fix with standard deviations when *cs is in use, give an error for use
206     of *fix with standard deviations before *cs.
208   + Add new *declination command with support for setting the declination
209     automatically from the IGRF model based on the survey date.  Thanks to the
210     Therion developers for the IGRF support code, which we're reusing.
211     Fixes #54, reported by Wookey.
213   + Allow the units for the zero error to be specified, making it easier to
214     specify calibration with a scale if you measure the zero error externally
215     (rather than using the instrument itself).  Fixes #61, reported by Andrew
216     Atkinson.
218   + Report the error from PROJ when coordinate conversion fails as part of the
219     actual error rather than on a separate line.
221   + Fix use after free after *solve.  This only occurs if a leg between the two
222     exact same stations appears right before and right after the *solve, which
223     is unlikely in real data, but the testsuite has an instance of this.  This
224     was introduced by the repeat leg averaging added in 1.2.17.
226   + Fix small memory leak when solving network.  This doesn't really matter
227     when solving at the end of processing as cavern will exit after that, but
228     if *solve is used we continue processing after solving.
230 * Remove compatibility handling for specifying a country variant of a language
231   in SURVEXLANG using "-" with a lower case country code (e.g. "en-us") - we
232   changed to the standard "en_US" way back in 2001.  This code was mangling
233   character sets with a "-" in, and is no longer useful.
235 * Ignore any "@<something>" modifier in the language code.
237 * Improve documentation of magnetic declination handling, and cover the new
238   "*DECLINATION" command.
240 * Document aven's command line options in the manual and its man page.
241   Reported by Jenny Black.
243 * Point to '*case' and '*truncate' from the 'SEE ALSO' sections of each other's
244   documentation.
246 * Remove references to SpeleoGen from the documentation - it hasn't been
247   updated for many years, and can't read recent versions of the .3d format.
249 * Strip documentation references to obsolete versions of MS Windows.
251 * doc/HACKING.htm: Update list of debian packages to install to build from git.
253 Changes in 1.2.20 (2015-06-26):
255 * aven:
257   + When printing, use the top margin rather than the right margin to calculate
258     the height of the printable area.  In practice, the two values seem to be
259     the same or very similar by default.
261   + Avoid assertion if the about dialog image fails to load.  Reported by Phil
262     Maynard.
264   + Optimise the size of the about dialog images.
266   + Add support for reading terrain data which isn't in a .zip file.
268   + Force a refresh after loading terrain data so that it gets displayed right
269     away.
271   + Make checks for terrain data extensions in zip files case insensitive.
273   + If reading terrain data fails, always report an error and never try to
274     display it.
276 * cavern: Allow clino readings in diving style data, suggested by Andrew
277   Atkinson.  Currently these readings are ignored, but a future version will
278   check that they're consistent with the angle given by the depth gauge and
279   tape, and perform suitable averaging.
281 * Remove lingering traces of svxedit.
283 * configure: Fix to allow compiling without libav/ffmpeg, as was possible
284   before 1.2.19.
286 * (Unix version): Install the filetype and aven application icons under
287   /usr/share/icons/hicolor, which is where they're expected to be these days.
289 * (Unix version): Add %f to Exec in survex-aven.desktop.
291 * (Mac OS X version): Remove useless extra copy of about box images from OS X
292   disk image.
294 * (Mac OS X version): Only ship one copy of each of the translations.
296 * (Mac OS X version): Reduce the size of the aven binary by disabling a load of
297   libav features we don't use.
299 * (Microsoft Windows version): Reduce the size of the aven binary by disabling
300   a load of libav features we don't use.
302 * (Microsoft Windows version): Update message files to fix a missing Chinese
303   message in the installer.
305 Changes in 1.2.19 (2015-06-18):
307 * aven:
309   + Fix exporting to GPX, KML and HPGL, which all failed to write the header to
310     the exported file in 1.2.18.
312   + Add exporting to Survex .pos format.
314   + If the measuring line isn't currently active, pressing "Escape" will now
315     exit full screen mode.
317   + (Mac OS X version): Change the shortcut for full screen mode to be the
318     standard Ctrl+Command+F (rather than Shift+Command+F which we have been
319     using since 1.2.7).
321   + (Mac OS X version): When we centre the view on the station this can
322     generate a mouse move event, so clear the variable which says we are
323     dragging before we process a left click on a station.  This avoids random
324     rotations of the survey when clicking on a station, reported in #47 by Hugh
325     St. Lawrence.
327   + (Mac OS X version): Force use of a non-native toolbar to stop the toolbar
328     icons from being rescaled and looking fuzzy.
330   + (Mac OS X version): Remove code added in 1.2.18 which tries to set stop the
331     toolbar icons from being rescaled, but which requires an unreleased version
332     of wxWidgets, had a typo in, and doesn't actually seem to work anyway.
334   + (Mac OS X version): Drop out of full screen mode if the mouse is mode to
335     the top of the screen, since we can't seem to display the menu bar in this
336     case like we do on other platforms.
338   + (Mac OS X version): Enable aven's movie export feature.
340   + (Mac OS X version): Enable wxDisplay when building wxWidgets to better
341     support multi-monitor setups.
343   + (Mac OS X version): Silence warning visible when aven is run from a
344     terminal about a missing CFBundleTypeRole.
346   + When reading terrain data from a .zip file, report an error if the .zip
347     file is bad, or if it doesn't contain any terrain data we recognise.
349   + Tweak error message in terrain reading code to distinguish two failure
350     cases.
352   + Add viewing angles and scale to footer, and shorten some of the other items
353     to make room for this extra information.  (Fixes ticket #52, reported by
354     Erin Lynch)
356   + If the footer is wider than the printout width, scale down the font used
357     so that it exactly fits; if the footer is narrower, than space out the
358     items in in so it uses the full width.
360   + If the saved size for aven's window exceeds the current display size
361     (mostly likely because we're now plugged into a smaller monitor), then
362     reduce the size of the window to fit the display.  If the saved size is <
363     (480x320), increase it to at least that, as aven isn't usable in a smaller
364     window.
366   + Remove crude bodge which tries to pick a nicer initial window size when
367     using wxWidgets without wxDisplay on a multi-monitor setup - aven now opens
368     with the same size window it had when it was closed, so the initial size is
369     only relevant on the first ever run.
371 * Assorted translation updates.  Notably Indonesian is at 100% again.
373 * Stop trying to catch and report signals.  The only real reason to do it is so
374   we can say "Bug in program detected! Please report this to the authors"
375   before we exit, but when the program crashes that's pretty obvious.  In aven
376   we try to pop up a message box for this message, which may fail due to
377   whatever caused the signal, while with the command line tools there's no
378   great benefit over just letting the shell report the signal.
380 * Use pkg-config to probe for libav and proj, which sorts out the correct flags
381   for building on OS X against a static install of libav.
383 Changes in 1.2.18 (2015-06-03):
385 * aven:
387   + Add support for reading terrain data (from a zip file containing either an
388     SRTM .hgt file, or an ESRI .bil file and associated metadata files), and
389     rendering it as a transparent surface.
391   + Remove actions from 'Orientation' and 'Rotation' menus which you wouldn't
392     sanely want to perform from the menu.
394   + Create a "Colour by" submenu of the "View" menu to house the various
395     colouring options.
397   + Add "Colour by Gradient" and "Colour by Length".
399   + Make the button to dismiss the "About" dialog "OK" rather than "Close",
400     which seems more logical, and also allows the dialog to be closed by
401     pressing "Escape".
403   + Destroy any existing clipping region before we write the page footer.
404     Hopefully solves ticket #52, reported by Erin Lynch.
406   + Don't round bearing and tilt angles to integers when printing and
407     exporting.
409   + Add passage export for EPS format.  (Partly addresses ticket #4)
411   + Add JSON export.  This should be regarded as experimental, and the format
412     is quite likely to change.
414   + Pressing F6 now toggles the display of rendering stats, currently FPS
415     (Frames Per Second) and the number of triangles in the terrain mesh.
417   + Add a menu item and toolbar button to show the cavern log window if the
418     currently shown survey data was processed by aven.  Reported by Hugh St
419     Lawrence in #47, and by Dave Clucas and others previously on the list.
421   + Add "Save Log" button to Aven's cavern log window.
423   + In cavern log window, highlight "error" markers in red and "warning"
424     markers in orange.
426   + Rework code to read cavern's output.  In particular, we no longer mix
427     buffered and non-buffered system calls.
429   + Aven's support for reading colours and font sizes for printouts from
430     print.ini has never worked - the contents of the ini files are ignored due
431     to a bug which has been there since the code was added in 2005 - but nobody
432     has ever complained.  So just strip out that code entirely - we should
433     support setting the colours and font sizes, but a GUI interface for setting
434     them would be better.
436   + Fix to compile with a Unicode build of wxWidgets 2.8.  Reported by Bill
437     Gee.
439   + Take the width of the messages used above the compass and clino into
440     account when calculating how much space to allow for them - now the labels
441     won't overlap or be cut off in translations where they are long.
443   + (Mac OS X version): Attempt to address the size of the toolbar icons.
445 * cavern:
447   + Reject *fix with SDs which aren't all positive.  (fixes#2, reported by
448     susscorfa).
450   + Use the currently set units when outputting measurements in warnings,
451     errors, and the stats at the end of the run.  Requested by Bill Gee.
453   + Include column number when a *include file isn't found.
455   + Show 'error' in front of error messages, like we show 'warning' in front of
456     warnings.  Fixes #48, reported by Wookey.
458   + Increase the threshold for warning that fore and back measurements differ
459     from 2 SDs to 3 SDs.
461 * findentrances: If the 3d file specifies the coordinate system, use it.
463 * svxedit: Remove svxedit - while an editor with built-in knowledge of survex
464   would be nice to have, svxedit doesn't really offer that, and it looks ugly
465   in a modern desktop.
467 * If we run out of memory while reading a processed survey data file, include
468   the filename in the error message.
470 * Many translation updates - notably Indonesian and Russian are now the two
471   most complete translations.
473 * (Microsoft Windows version): Add code page 1252 mappings for fancy quotes.
475 * Transliterate gradient and infinity symbols if the current character set
476   lacks them.
478 * Add SVG version of .plt icon.
480 * Manual:
482   + Add complete list of quantities you can set SDs for.  Thanks for Wookey for
483     highlighting that the previous list was incomplete.
485   + Document averaging of a group of repeated readings.
487   + Add a link to the sample data from the manual.
489   + Remove references to contact addresses which are no longer there.  Remove
490     offer to post people floppies, and references to a CD image which isn't
491     available for download.
493 * Remove non-breaking spaces from the diffpos and extend manual pages, as they
494   actually make the output formatting worse (presumably these used to work
495   around a since-fixed bug in one of the docbook processing tools).
497 * doc/TODO.htm: Update.
499 * Fix to compile without warnings with 'g++ --std=gnu++11'.
501 Changes in 1.2.17 (2015-02-24):
503 * MacOS X version:
505   + Update INSTALL file with current status.
507   + Aven.app now has a custom icon.
509   + Add icons for all the filetypes supported.
511   + Add Finder actions for .svx, .3d, .plt and .pos files.
513   + aven: Hide the status bar and tool bar in Full Screen mode, as wx doesn't
514     currently do this for us.
516   + aven: Fix short-cut for toggling Full Screen mode.
518   + aven: Make "About" menu item appear.
520   + aven: Fix "Close" button in about dialog.
522   + aven: Make custom cursors black with a white outline to match the standard
523     OS X cursor.
525   + svxedit: Now wrapped up in an application bundle as svxedit.app.  It
526     still doesn't really work like a standard app though - e.g. you can't load
527     files from Finder (instead run svxedit.app and use File->Open), the font
528     size of most menu items is wrong, the icon for the app is the wish icon
529     rather than the svxedit icon, shortcuts use Ctrl not the Cmd key, and
530     probably more.  I'd probably recommend using another editor (OS X comes
531     with TextEdit.app for example).
533   + The documentation is now in a "Docs" directory alongside the apps, rather
534     than in the rather less obvious "share/doc/survex" directory.
536   + Default to building for x86_64, since all modern Macs are 64 bit.
538   + Disable use of liblzma when building wxWidgets for OS X, which was
539     preventing the build from working on OS X 10.6.8.
541   + Download wx sources from SF via redirecting link.  Thanks to David A.
542     Riggs.
544   + buildmacosx.sh: Handle the mount point for the disk image containing a
545     space.
547   + Link with a static build of PROJ for doing coordinate system conversions.
549   + Build wx with --disable-webview to avoid a compilation failure on OS X
550     10.10.1.
552   + Use wx-config --cc and --cxx to get the compilers to use for building
553     everything else, as wx adds options to them which otherwise cause linking
554     errors.
556   + The diskimage (.dmg) file is now compressed with bzip2, which gives a
557     smaller download.  This means OS X 10.4 is required, but we probably
558     already need at least 10.5 because that's the minimum version which the
559     wxWidgets build supports by default.
561   + Remove unused files and copies of files from the diskimage.
563 * cavern: If the same leg is repeated consecutively, average the readings and
564   treat as a single leg.
566 * dump3d: Report SEPARATOR used by the file being read.
568 * aven.svg: Fix visual glitch in SVG icon for aven.  Noted by David A. Riggs.
570 * aven:
572   + Greatly reduce flicker when mouse is moved to the top of the screen in full
573     screen mode and the menu bar reappears.
575   + For export formats where scaling is supporting, aven now actually uses the
576     scale specified in the export dialog (previously it ignored this and used
577     1:500).
579   + Reimplement animation so that it's based on angular change per unit of
580     elapsed time, rather than averaging the time take for the last two scene
581     redraws.  This gives smoother animation in the face of variable load and
582     scene redraw time, and should be more consistent between platforms.
584   + Switching to a point of the compass during auto-rotation now jumps straight
585     there rather than the two animations fighting.
587   + Reduce the maximum auto-rotation speed, as the previous limit was uselessly
588     fast.
590   + Disable stepping the rotation angle when animating (previously we only did
591     when rotating).
593   + Speed up start-up a bit - rather than loading icons from individual PNG
594     files on disk, compile them into the aven binary.
596 * (Unix version): Add "MimeType" field to desktop files so that file
597   associations work out of the box with modern desktop environments.
599 * Add start of Hungarian translation from Imre Balogh.
601 * Merge in many updates to the Russian translation from "vsuhachev".
603 * Assorted minor updates to other translations.
605 * Create scalable (SVG) versions of file type icons.
607 * doc/manual.sgml: Remove $Id and $Date markers, as they don't get expanded now
608   we're using git.
610 * tests/: Improve test coverage in a few places:
612   + Extend tests of fore and back sights to test calibration of the back
613     compass.
615   + Test "Can't calibrate angular and length quantities together" error.
617   + Check that "*set names ." works when "." is also the decimal point.
619 Changes in 1.2.16 (2014-10-17):
621 * aven: Add KML export (stations only currently).
623 * aven: Allow measuring line to measure from anonymous stations.  (Fixes #44)
625 * aven: Fix corrupted names in exported files.
627 * aven: Fix error log window under wxWidgets >= 2.9 to include the system
628   information before the first log message like it does under wxWidgets 2.8.
630 * cavern: Add support for "*cs JTSK" and "*cs JTSK03".
632 * tests/: Improve test coverage.
634 * Translation updates for many languages, plus the start of translations to
635   Greek and Polish.
637 * Fix to build against wxWidgets 3.0 built with assertions disabled.  Reported
638   by Martin Sluka.
640 * Fix warnings when compiling with clang (which is the default compiler on
641   Mac OS X).  Reported by Martin Sluka.
643 Changes in 1.2.15 (2014-08-14):
645 * cavern: The *cs command now also supports "long-lat", "s-merc" (for "Web
646   Mercator"), EPSG and ESRI codes, "eur79z30", "ijtsk" and "ijtsk03".  This
647   means that we now support all the coordinates systems which Therion does,
648   except for a few which don't have X=East and Y=North.  The documentation
649   for *cs has also been improved.
651 * aven: We no longer persist full screen mode between runs - it's not a
652   standard behaviour of desktop programs, and it's too easy to go into full
653   screen mode from the menu and then not be able to get out again because you
654   don't know the required key shortcut. (ticket#39)
656 * aven: When in full screen mode, moving the mouse to the top of the screen now
657   makes the menu bar appear.  This provides a non-shortcut way out of full
658   screen mode, as well as making it easier to perform other operations while in
659   full screen mode.  The current implementation gives an annoyingly flickery
660   transition, but hopefully we can improve this in future. (ticket#39)
662 * (MacOS X version): If built with wxWidgets >= 3.1.0 (which is still in
663   development), we now call EnableFullScreenView() which improves the full
664   screen mode experience on OS X 10.7 and later.
666 * img library: Improve documentation for img_ERROR_INFO.
668 * tests/: Ship some missing .out files and compare.tst.
670 * tests/: cavern.tst testcase back2 is now actually used.  Fix a bug in this
671   testcase, and extend it to cover a variant of the situation reported as a bug
672   in therion by Bill Gee to the therion list.
674 * (Linux version) survex.spec: Add run-time requirement on proj and proj-epsg
675   for the survex package and on tk for the svxedit package.
677 Changes in 1.2.14 (2014-07-05):
679 * img library: Add ability to store a PROJ4 string describing the coordinate
680   system in use in 3d v8 files.
682 * aven: If the 3d file specifies a coordinate system, then use it for exporting
683   to formats which need to know (currently GPX).  If the input file doesn't
684   specify the coordinate system, allow the user to enter a PROJ4 string in the
685   export dialog.
687 * aven: You can now quickly zoom to a particular area by holding down the
688   "Shift" key and dragging with the left mouse button to create a rectangular
689   "rubber band box" around the area you wish to zoom to.  If you release the
690   "Shift" key while still dragging, the box is centred on the start point
691   rather than having one corner there.
693 * aven: Fix exporting of passage tubes in elevations and extended elevations
694   - previously up and down were getting drawn across the page!
696 * aven: Fix "Cancel" to work on the print/export dialog, broken by changes in
697   1.2.13.  (Reported by Brian Clipstone)
699 * aven: Fix the conditions on which the menu item "Cancel measuring line" is
700   enabled - previously it was hard to actually cancel it via the menu.
701   Reported by Hugh St Lawrence.
703 * aven: Fix wx assertion failures when showing hit test debug view on platforms
704   such as 64-bit Linux.
706 * aven: When viewing from above, show "Plan" above the "clino" which indicates
707   the tilt angle (instead of "Elevation -90°").
709 * aven: The extended font data now loads faster, and also uses less memory on
710   64-bit platforms.
712 * aven: Dragging the vertical divider between the side panel and the 3D view
713   now only updates when you finish the drag, as redrawing continuously just
714   looks clunky except on an ultra-fast machine.
716 * aven: (German translation) Abbreviate "Blickrichtung" so it doesn't overfill
717   the space available in the aven UI.
719 * cavern: Add a *cs command to allow setting the coordinate system for *fix
720   commands, and the coordinate system used for processed survey data.  The
721   latter is now stored in 3d v8 format files.
723 * cavern: Add support for 'L' flag (exclude from length) in Compass .dat files
724   and handle it in the same way as the "DUPLICATE" flag in .svx files.
726 * cavern: If there's more than one *fix command with coordinates, still
727   actually fix the second and subsequent ones, to avoid triggering bogus errors
728   about unconnected surveys.
730 * cavern: If there's more than one *fix command with coordinates, report the
731   station name of the previous one, plus the file and line number where it was.
733 * cavern: Fix handling of the rather contrived case of *fix with no coordinates
734   followed by *solve and then another *fix with no coordinates not to access
735   freed memory.
737 * dump3d: Report any specified coordinate system.
739 * doc/3dformat.htm: Update to document how the coordinate system is stored.
741 * (Microsoft Windows version): Include dump3d in the installer.
743 * Fix a compiler warning.
745 * Improve test coverage.
747 Changes in 1.2.13 (2014-05-15):
749 * aven: Fix --print option to wait for printing to happen before exiting
750   (previously it would exit right after opening the print dialog, so you
751   couldn't actually print anything out using it).
753 * aven: Increase the threshold for how close the pointer needs to be to a
754   station from 5 pixels to 7 to try to help touchscreen users.  Reported by
755   Hugh St Lawrence.
757 * aven: Add "fat finger" mode, toggled by pressing F2, to allow investigating
758   if increasing the minimum pointer to station threshold helps Hugh's problems
759   with using aven on a touch screen device.
761 * aven: The measuring line was unable to see stations which had just been
762   revealed by toggling surface or underground legs on - this is now fixed.
764 * aven: Add "hit test grid debug" mode, which shows the hit test grid and how
765   many entries are in each box (toggled by F3).
767 * aven: Pressing F4 now allows the user to toggle wxWidgets assertion messages
768   off and back on.
770 * aven: Create the empty hit-test grid data structure lazily, to reduce start
771   up time a little.
773 * cavern: Improve messages which talk about "tags" and/or "prefixes" in *begin
774   and *end commands to instead talk about "survey names".
776 * cavern: For ages cavern has warned if you reentered a survey, but this
777   warning was suppressed if it occurred at the same line of the same file as
778   the survey was first entered, but this can only happen if you include the
779   same survey file more than once, which isn't a sensible thing to do for a
780   file with actual survey data in (you might reasonably do it to set up survey
781   grade details or something like that).  The warning is now given in this
782   situation too.
784 * cavern: After 5 warnings about reentering a survey we give up warning about
785   it, but we used to keep reporting where the survey was originally entered -
786   this secondary diagnostic message is now silenced when the main message is.
788 * (Microsoft Windows version): Compile C code with optimisation on.
790 * Add the start of a Russian translation, with messages take from therion.
792 * Minor translation updates to French.
794 * Fix compiler warning from GCC.
796 * Testsuite improvements:
798   + Test that "..." anon station works.
800   + cavern.tst: Check number of errors returned by all testcases which should
801     fail and give an error count.
803   + cavern.tst: Fix to actually fully test everything when builddir != srcdir.
805 Changes in 1.2.12 (2014-04-14):
807 * aven: Fix measuring line to show change in altitude rather than altitude
808   itself (accidentally broken by changes in 1.2.11).  Reported by Brian
809   Clipstone.
811 * aven: Fix printing when built with wxWidgets 3.0.
813 * aven: Several visual improvements to printouts:
815   + Move the numbers below the scale bar down a little so that they don't
816     overlap the scale bar ticks.
818   + Set the clipping region after we draw the page border and info box to avoid
819     clipping the border in print preview.
821   + Tidy up the appearance of the compass and elevation arrow.
823 * aven: Fix to build with libav 10.  Reported by Moritz Muehlenhoff in
824   <http://bugs.debian.org/739332>.
826 * aven: Fix to build with older libav where avcodec_free_frame() isn't
827   available.
829 * (Linux version) survex.spec: Update spec file used for building RPM packages.
831 * (Unix version): Add "Keywords:" entry to .desktop files.
833 * (Unix version): Enable large file support, mostly to support filing systems
834   which return 64 bit inode values, such as CIFS mounts.
836 * (Microsoft Windows version): Only allow "A-Z" or "a-z" for driver letters,
837   rather than any character which is a letter in the current locale.
839 * Various translation updates.
841 Changes in 1.2.11 (2014-01-28):
843 * aven: Fix wxWidgets assertion when double clicking on an anonymous station.
844   Reported by Kevin Dixon.
846 * aven: Embed the font data for the first 256 Unicode characters for use in the
847   survey pane into the compiled aven binary to reduce start up overhead.  Any
848   additional characters needed are loaded from a data file only if/when a
849   character >= U+100 is actually needed (as before).
851 * aven: Fix display of Unicode characters above 256 when there's a character
852   <= 256 earlier in the same string.
854 * aven: Use the actual width of Unicode characters above 256 rather than
855   assuming they are 16 pixels wide.
857 * aven: If full screen, don't show the side panel when a new file is opened
858   (e.g. via Ctrl+O).
860 * aven: Don't give an assertion failure when showing passages for a cave with
861   no vertical extent.  Reported by Jonny Prouty.
863 * aven: Change terminology in print dialog - say "legend" instead of "info
864   box".
866 * aven: Add option to show the tilt angle as a percentage gradient.
868 * aven: Show the units (degrees, grads, or percent) for the tilt and bearing
869   indicators.
871 * aven: All length units are now translatable.
873 * aven: Split log_fl_error helper function out of CHECK_GL_ERROR macro, which
874   will reduce code size and also the number of deprecation warnings about
875   gluErrorString on Mac OS X 10.9.
877 * (Microsoft Windows version): aven: Try to work around redraw issues related
878   to the measuring line by redrawing the whole window, which doesn't seem to be
879   measurably slower.
881 * cavern: If *units is used to try to set units for LEVEL, PLUMB, or POSITION,
882   give an error rather than quietly ignoring the attempt.
884 * cad3d: Make cad3d remap control characters and spaces in station names when
885   generating PLT output in the same way aven does.
887 * Various translation updates (particular thanks to Eric Madelaine and Dennis
888   Baudys), including the start of a Bulgarian translation, with messages taken
889   from Therion and elsewhere.
891 * (Microsoft Windows version): On Microsoft Windows 2000 and newer, use
892   GetUserDefaultUILanguage() to get the UI language to use.  For older
893   versions, continue to use GetUserDefaultLCID().
895 * (Microsoft Windows version): The Indonesian translation will now be used
896   automatically when the system language is set to Indonesian.
898 * (Mac OS X version): Fix to build with wx 3.0.0 on OS X 10.9.  Thanks to David
899   A. Riggs for his work on this.
901 * (Mac OS X version): Update buildmacosx.sh script to use wx 3.0.0, and add a
902   checksum check for the downloaded wx sources.
904 * Fix a lot of the compiler warnings when building with clang.
906 * doc/manual.sgml: Add missing quantities to the list documented as accepted by
907   *units: LEFT, RIGHT, UP/CEILING, DOWN/FLOOR (missing entirely);
908   BACKCOMPASS/BACKBEARING, BACKCLINO/BACKGRADIENT (missing from the main list,
909   mentioned in list of the units that can be set for them); COUNT (missing
910   alternative name for COUNTER); DX/EASTING, DY/NORTHING, DZ/ALTITUDE
911   (incorrectly listed as X, Y, Z).  Reported by Jonny Prouty.
913 * Test suite: Improve test coverage for cavern.
915 Changes in 1.2.10 (2014-01-15):
917 * aven: Fix assertion if two mouse buttons are held down at the same time.
918   If dragging with more than one mouse button held down, releasing one causes
919   another which is still held down to take effect.  Reported by Brian
920   Clipstone.
922 * aven: If we fail to start the external editor when the user clicks on an
923   error or warning from cavern, show an error box.
925 * aven: If the survey has a title, add it as a top-level <title> element to
926   exported SVG files.
928 * aven: Escape '<', '>', and '&' in labels in exported SVG files.
930 * aven: In GPX export, set the <time> element to the datestamp from the 3d
931   file.
933 * aven: Don't try to write the title if it isn't set or is empty when exporting
934   GPX files.
936 * aven: Don't bother looking up the printer page setup info when exporting.
938 * (Microsoft Windows version): aven: Fix crash on "File->Print" or
939   "File->Export" under Windows XP, reported by Brian Clipstone.
941 * (Microsoft Windows version): aven: Fix error dialog about an incorrectly
942   encoded filename which could occur if run without being asked to load a file
943   on startup.
945 * (Microsoft Windows version): aven: Compile with optimisation on.
947 * img library, aven: Although processed CMAP data files are often referred to
948   as "CMAP .XYZ files", it seems that actually, the extension .XYZ isn't used,
949   rather .SHT (shot variant, produced by CMAP v16 and later), .UNA (unadjusted)
950   and .ADJ (adjusted) extensions are.  Since we've long checked for .XYZ, we
951   continue to do so in case anyone is relying on it, but also check for the
952   other extensions.
954 * img library: Add new "datestamp_numeric" field to struct img giving the
955   datestamp as a time_t in UTC (or (time_t)-1 if there's no datestamp or we
956   failed to convert it).  For .3d >= v8, this field is reliable.  We attempt to
957   convert date strings in .3d <= v7 and CMAP XYZ files, but may get the
958   timezone wrong.
960 * img library: Fix my_strcasecmp() to handle top-bit set characters better.
962 * cavern: Fix NULL pointer dereference when processing Compass DAT file without
963   'SURVEY DATE:'.
965 * doc/manual.sgml: Update references to Survex 1.1 which should be to 1.2.
967 * doc/manual.sgml: Note the station length limit Smaps used.
969 * Fix some compiler warnings if built with glibc's fortify source feature
970   enabled.
972 Changes in 1.2.9 (2014-01-08):
974 * Document --3d-version in cavern man page and the manual.
976 * aven: Fix compilation error in movie export code with recent libavi.
978 * aven: Fix warning on stderr when export a movie as MPEG.
980 * img library: In non-hosted mode, don't define GETC and PUTC if they're
981   already defined, to allow easy overriding with getc_unlocked() and
982   putc_unlocked() (which are significantly faster on Linux).
984 * img library: In non-hosted mode, check that int is at least 32 bits,
985   and if not, use long.  In practice, platforms with 16 bit int are mostly
986   obsolete, but it's not hard to be portable here.
988 * img library: Add test that img.c and img.h compile in non-hosted mode
989   (regression test for issue fixed in 1.2.8).
991 * (Microsoft Windows version): aven is now built with wxWidgets 3.0.0.
993 * Update translations from launchpad and from existing similar messages.
995 * Fix some compiler warnings.
997 Changes in 1.2.8 (2013-10-29):
999 * cavern: Fix handling of anonymous wall stations ('..' by default) to
1000   implicitly set the SPLAY leg flag, as was intended.  Reported by Thomas
1001   Holder.
1003 * cavern: Tweak .err file output not to lose the space in front of certain
1004   statistics when the value gets large.
1006 * cavern: Eliminate redundant progress message when solving simultaneous
1007   equations.
1009 * aven: Add a format drop down to the export dialog, and only show fields which
1010   are meaningful and supported for the currently selected export format.  The
1011   format defaults to that used most recently.  The "Elements" and "View" boxes
1012   have been swapped in the print and export dialogs as that layout works much
1013   better when the "View" box is hidden.
1015 * aven: Changing checkboxes in the print or export dialog didn't work in 1.2.7
1016   - now works again.  Reported by Anthony Day.
1018 * aven: Add GPX export (based on findentrances patch from Olaf Kähler).  In
1019   this release the projection which the survey coordinates are in defaults
1020   to the BMN M31 grid used in the Totes Gebirge in Austria.  On Unix, you
1021   can edit ~/.aven and add a new line setting 'input_projection' to a PROJ
1022   projection string.  The ability to specify this projection in a better
1023   way is coming soon.
1025 * aven: New export options "Origin in centre" and "Full coordinates" - the
1026   latter fixes #10.  GPX and PLT output implicitly force "full coordinates".
1028 * aven: The "Sketch" vector drawing program got renamed to "Skencil" some
1029   time ago, so update references.
1031 * aven: Make the Presentation->Play menu item a checkbox, to avoid a warning
1032   with wxMSW 2.9.5.  Reported by Brian Clipstone.
1034 * aven: Make right click in an empty presentation mark the current position and
1035   open it to edit, instead of crashing.
1037 * aven: Update movie export code to work with latest libav API.  Reported by
1038   Sebastian Ramacher.
1040 * aven: Improve reporting of errors during the process of exporting a movie.
1042 * aven: Don't try to close the movie if we aren't producing one.
1044 * aven: Fix assertion failure when double-clicking on the survey with wx2.9.
1046 * aven: Fix to build with wxMSW 2.9.5.
1048 * aven: Fix to build with wx 2.9.5 with wx2.8 compatibility disabled.
1050 * cad3d: The "Sketch" vector drawing program got renamed to "Skencil" some time
1051   ago, so add a new --skencil option to specify this output format.  The old
1052   name (--sketch) is still recognised for compatibility.
1054 * cad3d: Make --marker-size work for Skencil and SVG output.
1056 * dump3d: Make --show-dates option show dates for XSECT.
1058 * img library:
1060   + Fix to work once more when used outside of Survex (missing definition of
1061     max() macro and a bad call to free() in img_close() for a file opened for
1062     reading).
1064   + Use lround() instead of round(), and make the tests around whether we use
1065     the library function or the our fallback implementation saner.
1067   + Fix // comments in C code for portability to pre-C99 compilers which don't
1068     support these as an extension.
1070   + Can now be compiled as C++ as well as as C.
1072 * (Microsoft Windows version): The installer is now built with a newer version
1073   of Innosetup, and includes translations for all the languages which Survex
1074   itself has any translations for.
1076 * (Microsoft Windows version): aven is now built with wxWidgets 2.9.5.
1078 * Minor translation updates.
1080 * tests/Makefile.am: Distribute files for "normal_bad" testcase.
1082 Changes in 1.2.7 (2013-07-27):
1084 * Add support for anonymous stations, which are indicated by one, two or three
1085   separator characters - with the default separator of '.', that means '.',
1086   '..', and '...' are anonymous stations.  Single separator ('.' by default)
1087   is an anonymous non-wall point, double separator ('..' by default)
1088   is an anoymous wall point at the end of an implicit splay), and triple
1089   separator ('...' by default) is an anoymous point (with nothing special about
1090   the leg).  A new *alias command allows '-' to be mapped to '..' for
1091   compatibility with pocket topo: *alias station - ..
1093 * New version 8 of the 3d format:
1095   + Supports new flags img_SFLAG_ANON and img_SFLAG_WALL.
1097   + New explicit file-wide flag for 'this is an extended elevation', rather
1098     than modifying the survey title to indicate this.
1100   + The survey prefix is often unchanged from one leg to the next, so use a
1101     spare flag to compactly indicate when there's no label change.
1103   + The data style of each leg is now stored.
1105   + The "processed at" time is stored as seconds since 1970 rather than a
1106     human-readable string.
1108   + Since 3d v8 features significant changes to the format, the format
1109     documentation for v7 and earlier has been split off into 3dformat-old.htm.
1111 * img library:
1113   + New station flags img_SFLAG_ANON and img_SFLAG_WALL.
1115   + Handle .pos files containing unnamed stations - don't suck the next line in
1116     as the station name, and set img_SFLAG_ANON for them.
1118   + Repurpose the long unused fBinary parameter to img_open_write() as a flags
1119     parameter, and add img_FFLAG_EXTENDED to specify that this is an extended
1120     elevation, in place of appending " (extended)" to the title.  Internally we
1121     still append this to the title (and remove it upon reading) when writing
1122     3d v7 or earlier, but for the new 3d v8 format, this flag is stored
1123     explicitly in the file.
1125   + img.h: Add comments for the lists of "Leg flags" and "Station flags".
1127 * aven:
1129   + We now require at least wxWidgets 2.8.0 - it was released over 6 years ago
1130     now, and the wx developers consider even 2.8 to be rather long in the
1131     tooth.  We stopped testing building with wxWidgets 2.6 some time ago, and
1132     formally dropping support for older versions allows a number of workarounds
1133     to be removed from the aven source code.  Also, features deprecated in
1134     wxWidgets 2.9 are no longer used in our code.
1136   + Don't run incremental search on every key-press, as on a slow machine the
1137     short initial search(es) will take a while but not be useful.  Instead only
1138     actually run the search when we're told there are no more key-presses
1139     queued up.
1141   + Implement support for including cross-section information in exported SVG
1142     and DXF files (ticket#4).  The DXF export is untested currently.
1144   + Show splay legs faded by default, with menu options to hide them or show
1145     them like other legs.
1147   + Speed up loading a .3d file with cross-sections by using a map to convert
1148     station names to positions.
1150   + In the cavern log window, don't highlight a file:linenumber if there's no
1151     message after it, which avoids highlighting the "Included from" lines
1152     wrongly.
1154   + Fix not to crash when trying to report an error while starting up.
1156   + (MacOS X version): Change the menu shortcut for "Full Screen Mode" to be
1157     the OS X standard shortcut Shift-Command-F (previously we used F11, but
1158     that's used by the desktop).
1160   + Add checks for errors when reading the font file.
1162   + Remove useless extra quoting when invoking vim to show the location of an
1163     error from cavern.
1165   + Include GL/gl.h before GL/glext.h (needed on Debian wheezy).
1167   + Use wxValidator to simplify keeping svxPrintDlg member variables and fields
1168     in the dialog in sync.
1170 * cavern:
1172   + Demote errors about invalid dates to warnings, since we've accepted *date
1173     for ages without any checks on the value, and so existing datasets
1174     probably contain invalid dates and dates in other formats.  (ticket#19)
1176   + New *alias command allows '-' to be mapped to '..' for compatibility with
1177     pocket topo: *alias station - ..
1179   + We want to warn if there's a clino reading which it would be impossible to
1180     have read from the instrument (e.g. on a -90 to 90 degree scale you can't
1181     read "93" (it's probably a typo e.g. for "39").  However, the gradient
1182     reading from a topofil is typically in the range 0 to 180, with 90 being
1183     horizontal.  Really we should allow the valid range to be explicitly
1184     specified, but for now we infer it from the zero error - if this is within
1185     45 degrees of 90 then we assume the instrument can read between 0 and 180
1186     degrees.
1188   + If the survey isn't all connected, still run survey tree checks and report
1189     errors and/or warnings which might suggest typo locations.  Thanks to Kevin
1190     Dixon for the report which highlighted this issue.
1192   + Report a warning if *begin SURVEY has a separator character in SURVEY.
1194   + Report column numbers as well as line numbers for some cavern errors and
1195     warnings.
1197   + Adjust width of node stats table to fit longest count when there are more
1198     than 9999 of a particular order of node.
1200   + If the argument to *include has an opening double quote but the closing
1201     double quote is missing, then skip trying to open the file.
1203   + Move "Station X referred to just once" warning after non-existent survey
1204     check - if both fire, the non-existent survey error is likely to be more
1205     relevant.
1207   + We no longer follow an error for a bad reading in passage data with a bogus
1208     "End of line not blank" error, but instead check the remaining readings on
1209     the same line.
1211   + We no longer follow an error about OMIT for a required reading with a bogus
1212     "End of line not blank" error.
1214   + Report an error if the scale factor in *calibrate is zero - it doesn't make
1215     sense and probably means someone reversed the arguments to *calibrate.
1217   + Report the parent include files starting from the outermost, as that's more
1218     logical when there are multiple levels involved.
1220   + If we were expecting a numeric field and instead get something which starts
1221     with '+', '-', or '.' but which isn't a number, then fix the error to
1222     include that character in the token reported.
1224   + Simplify handling of quantity lists to only recognise 'DEFAULT' as the
1225     first item.
1227 * cad3d: Check for errors from img_rewind() and report them.
1229 * dump3d:
1231   + Build, install and package dump3d as standard - it's useful for grabbing
1232     info from 3d files in scripts.
1234   + Add --show-dates option.
1236   + Show only 2 decimal places on coordinates and passage dimensions.
1238   + Report the data style of legs.
1240   + Report if the file is an extended elevation.
1242   + Report img_STOP as STOP rather than CODE_0xffffffff.
1244 * Test suite:
1246   + cavern.tst: Fix equatenosuchstn testcase (added in 1.2.6) to normalise the
1247     expected output so it passes reliably.
1249   + cavern.tst: Run diffpos <expected> <actual> so the reports of 'Added' and
1250     'Deleted' stations upon failure are the more natural way round.
1252   + Add more testcases, expand some existing testcases, and add expected output
1253     for more.
1255 * (Microsoft Windows version): Use wx-config's --cc and --cxx flags to find the
1256   appropriate C and C++ compilers to use, and link mingw build statically to
1257   avoid needing the libgcc DLL (which newer GCC seems to have by default).
1259 * (Unix version): When determining the character set for command-line tools,
1260   check environmental variable LANG after LC_ALL and LC_CTYPE.
1262 * When determining the language, check environmental variable LC_ALL before
1263   LC_MESSAGES and LANG (but after SURVEXLANG).
1265 * If we don't find the message file, only give an error if it was specified
1266   with SURVEXLANG, since that is an explicit instruction to Survex, whereas
1267   LANG, LC_ALL and LC_MESSAGES are essentially system "preferred locale"
1268   settings.
1270 * There are a handful of hard-coded English message strings for reporting
1271   errors trying loading message files, etc.  These are all now ASCII, as if we
1272   fail trying to open a message file, it's more likely the encoding isn't
1273   set correctly.
1275 * Prune strings we are no longer using and are probably unlikely to use again
1276   into a new file po_codes_dead, so that translators don't get presented with
1277   them to translate.
1279 * Merge lots of translation updates.  Most translations are now complete or
1280   close to complete.
1282 * Add start of Indonesian translation from Arief Setiadi Wibowo.
1284 * Fix various compiler warnings when building from source.
1286 * Include scripts gdtconvert and gen_img2aven in the source distribution.
1288 Changes in 1.2.6 (2012-02-23):
1290 * (Mac OS X version): Fix so that cavern finds its messages when run by aven.
1292 * (Microsoft Windows version): Include JPEG images for aven in the installer
1293   package (ticket#35).
1295 * cavern: If we have a reference to a station in a non-existent survey, give a
1296   helpful error rather than saying the station hasn't been exported from the
1297   survey.  (Bug reported by Martin Green via email)
1299 * aven: Fix to build with a non-Unicode wxWidgets library.  Patch from Olaf
1300   Kahler.
1302 * findentrances: Add findentrances utility from Olaf Kahler which produces a
1303   .gpx file with waypoints for entrances.  This needs libproj so is disabled
1304   by default for this release - to enable it install the development stuff for
1305   libproj and build survex with:
1307       make FINDENTRANCES=findentrances
1308       make install FINDENTRANCES=findentrances
1310 * dump3d: Add support for showing img_ERROR_INFO items.
1312 * doc/3dformat.htm: Merge in some improvements from Mike McCombe.
1314 * Incorporate a French translation from launchpad I'd previously copied the
1315   English version of by mistake.  Attempt to correct mistranslation of "survey
1316   file".
1318 Changes in 1.2.5 (2012-01-03):
1320 * aven:
1322   + The survey tree in the left panel is now in sorted order once more.
1324   + No longer fails with an assertion if used for a long time (we were leaking
1325     an OpenGL list each time one had to be regenerated).
1327   + Now builds with newer FFmpeg library.
1329   + Draw measuring line in front of the indicators rather than behind them.
1331   + Loading a new file (or reloading the current one) no longer invalidates
1332     the OpenGL lists for the compass and clino, so will be a fraction faster.
1334 * Improve handling of attempts to look up translated messages before the
1335   message subsystem is fully initialised (which only happens if there's an
1336   error early on).
1338 * Improve the survex(7) man page text, and fix it to be marked as section 7 in
1339   the man page source as well as in the filename.
1341 Changes in 1.2.4 (2012-01-01):
1343 * aven:
1345   + A change in 1.2.3 meant that aven tried to use OpenGL before it was
1346     initialised, which doesn't cause problems in some machines, but causes aven
1347     to abort on others.  This is now fixed, and there's a check in place to
1348     help avoid similar issues in future. (ticket#34)
1350   + Always use metres or feet for the depth colour key, and chose a consistent
1351     precision by looking at the depth range. (ticket#30)
1353   + Show the depth units below the colour bar rather than after every value.
1355   + When zooming way in, stay in metres rather than switching to cm.
1357   + On the scale bar, say “1 mile” rather than “1 miles”.
1359 * Translation updates for Catalan, French and Slovak.
1361 Changes in 1.2.3 (2011-12-31):
1363 * Fix to build with wxWidgets 2.9.2.
1365 * (Mac OS X version):
1367   + Processing .svx files from aven now works.
1369   + Remove spurious blank lines from the licence text in "Get Info".
1371   + Don't create the help menu at all, as it is empty (because the "About"
1372     entry goes elsewhere) and sometimes seems to appear in the UI.
1374   + INSTALL.OSX: Update to reflect current status.
1376 * aven:
1378   + Fix Y coordinates of surface surveys on printouts.  (Closes #32)
1380   + Improvements to text plotted on the survey pane:
1382     - Support plotting Unicode character points > 256 by lazily loading the
1383       data for them from the font file and plotting them with a direct call to
1384       glBitmap(), which is slower but doesn't require a display list per
1385       character.
1387     - Adjust the spacing from fixed width to putting a one pixel gap either
1388       side of each one character (so two between adjacent glyphs).  Mostly this
1389       reduces the horizontal width, but it adds a pixel for characters like "m"
1390       and two in a few cases.
1392     - Fix .pixelfont file generation to correctly handle characters wider than
1393       8 pixels.
1395   + Fix expected cross shape so don't always reject using texture mapping to
1396     draw crosses.
1398   + As we read a survey file, eliminate tubes consisting of zero XSECTs as well
1399     as those consisting of just one.  Previously we would trip over the empty
1400     tube later.  Such tubes can for example be created by extend if a splay shot
1401     is the start or end of a tube.
1403   + Make the green colour used for entrances in the survey tree the same
1404     (slightly darker than before) green used for the entrance blobs.
1406   + Report the version of the library we're actually running with if built
1407     against wx >= 2.9.2.  Make it clear that the version reported is the
1408     version *built* with for wx < 2.9.2.
1410 * extend:
1412   + Copy the end markers for passage tubes.
1414   + Preserve left and right data for tubes (previously they were set to -1.0
1415     which means "no info").
1417 * img library: Fix incorrect comment in img.h which claimed that img_XFLAG_END
1418   was no longer used - it certainly is!
1420 * Use curly double quotes instead of "`" and "'" to quote filenames, etc in
1421   messages, and curly single right quote instead of straight ASCII apostrophe.
1422   Fall back to using straight ASCII versions if we can't represent them in the
1423   current character set.
1425 * Translation updates for Catalan, French, Slovak and Spanish.
1427 * Test suite:
1429   + Add test coverage for interleaved diving data.
1431   + Add testcase for diving data with topofil-style distance.
1433 Changes in 1.2.2 (2011-10-06):
1435 * aven:
1437   + Replace the textured-mapped font drawing with an approach based on
1438     glBitmap.  This doesn't suffer from the character alignment issues which
1439     the textured-mapped fonts had, and is actually significantly faster on some
1440     machines.  The current font used is (mostly) fixed-width, but this isn't an
1441     inherent limitation - it was just the easiest font data to convert to a
1442     usable format.
1444   + Fix assertion failure due to rounding differences on loading certain .3d
1445     files.  (ticket#26)
1447   + Fix assertion failure when turning on 3D passages if they stick out higher
1448     or lower than any station.  (ticket#29)
1450   + Fix grid not to disappear when blobs are turned on and blobs are drawn
1451     using lines.
1453   + If a degree sign isn't available in the character set in use, transliterate
1454     it to 'dg' rather than skipping it.
1456   + Fix message which should have been a degree sign but got lost in the format
1457     change for 1.2.0 and then got reassigned in 1.2.1.  Externally, this means
1458     that bearings in the status bar now have a degree sign after them if they
1459     are in degrees rather than nothing (1.2.0) or "&Hide Compass" (1.2.1).
1461   + Fix print dialog to calculate the scale required for "One page" right
1462     before it calculates how many pages are required, so we don't end up
1463     something other than 1x1 being shown when the user changes settings.
1465   + Update the calculations for picking a scale and for deciding how many
1466     pages are needed to take into account the change in info box height made
1467     in 1.2.1.
1469 Changes in 1.2.1 (2011-10-04):
1471 * Translation updates for US English.
1473 * aven:
1475   + Rename the "depth bar" to "colour key" in documentation, menus, etc since
1476     it now shows colours for dates and errors as well as depths.
1478   + In the colour key for "colour by date", change "No info" to "Undated".
1480   + Remove the dark grey background from the colour key and just put a single
1481     pixel black border around the colours.  This is more in keeping with the
1482     other controls, and means the colours are now on a black background so more
1483     visually similar to the survey legs.
1485   + Move the colour key's "Undated"/"Not in loop" entry down a little to
1486     improve the appearance.  Make each section a pixel taller.
1488   + Allow "Colour by X" to be selected even if there's no data for X or only a
1489     single value of X used (the colour key is much smaller in these cases, and
1490     does still provide some useful information).
1492   + Fix incorrect calculation of depth colouring for survey legs which straddle
1493     a depth band boundary.
1495   + The scale bar, compass, clino, and colour key now all have right click
1496     menus which allow related actions to be performed (especially handy in
1497     full-screen mode).
1499   + Improve the font used on the survey pane - it now contains the '-'
1500     character (so the clino now shows negative angles as negative, and dates
1501     in the colour key are now hyphenated).  Also the spacing and alignment
1502     are a little better, though still not perfect.
1504   + PLT file export now handles spaces and control characters in station names
1505     by escaping them with '%' as in URLs.
1507   + Pressing "Enter" on a station in the tree control now centres the view on
1508     that station.
1510   + The scale bar is now cached in an OpenGL display list since it often gets
1511     redrawn exactly the same - for example, when rotating, panning, etc.
1513   + Pressing "F5" forces all cached OpenGL drawing lists to be invalidated and
1514     then forces a refresh of the survey pane.  This is intended as a debugging
1515     aid - if pressing F5 changes the display at all then there's a missing case
1516     where a list should have been invalidated (please report if you find such
1517     a case as it is a bug).
1519   + We now automatically track which OpenGL display lists need to be
1520     invalidated on window width or height changes.
1522   + Increase scale bar maximum width from 65% of the window width to 75% as it
1523     was in 1.0.x (except that if that would overlap the clino we now reduce
1524     that proportion down until it reaches 50%).  Make the limit of zooming in
1525     the same as in 1.0.x.  (ticket#23)
1527   + (Linux version): Previously wxGTK didn't really handle showing a dialog if
1528     the application was fullscreen (the dialog got opened under the main
1529     window!)  To work around this, aven would switch out of full screen mode
1530     temporarily while showing a dialog.  This case works properly with recent
1531     wxGTK, so disable our workaround with versions we know work.  Also, apply
1532     the workaround only for wxGTK, not everywhere except on Microsoft Windows
1533     as there's no reason to think we need it for other platforms.
1535   + Grey out the "View North" action when we're already viewing North, and
1536     similarly for other compass points.
1538   + (Mac OS X and Microsoft Windows versions): Fix missing newline to OpenGL
1539     info in the "About" dialog.
1541   + Fix to set the correct filename on the root of the survey tree - previously
1542     the filename of the previous file loaded was used!
1544   + The movie export code now works with newer versions of the FFmpeg libraries
1545     as well as still working with older versions.
1547   + Fix mixed up messages - the print dialog now says "View" on the left
1548     subgroup of controls rather than some unrelated message.
1550   + On printouts, combine the "Plan View"/"Elevation" info box field with the
1551     field which gives the bearing and reduce the height on the info box by the
1552     removed field, so it's now 3cm for plans and elevations, as for extended
1553     elevations.  Report the tilt angle for tilted elevations which it seems has
1554     been missing for ages (it's not in recent 1.0.x either).
1556   + Tweak the exact positioning of informational text on printouts to look
1557     nicer and make better use of the available space.
1559   + Add keyboard mnemonics to the "Plan" and "Elevation" buttons in the print
1560     dialog.
1562   + Make the sign of the tilt angle for printouts consistent with the sign
1563     shown by the "clino" in the survey pane.
1565   + In the "Print" dialog, when in plan view disable the "Plan view" button,
1566     and similarly for the "Elevation" button.
1568   + (Microsoft Windows version): Sort out appearance of custom cursors.
1570   + If a label isn't valid UTF-8 or CP1252, fall back to ISO8859-1.
1572   + (Mac OS X version): F11 puts aven into full screen mode, but apparently
1573     you can't get out again easily, so add code to explicitly check for F11
1574     being pressed and toggle full screen.
1576 * (Linux version): Fix the RPM .spec file for where man pages now get installed
1577   and package aven.svg and the vim support files.  (Fixes from James Begley)
1579 * "make check" now performs several checks on the translation files.
1581 * More messages are now available to be translated.
1583 * cavern: Fix reporting of ranges of survey coordinates, which was broken by
1584   the message handling changes in 1.2.0.
1586 * Fix warning when compiling with GCC.
1588 * INSTALL: Mention building wxWidgets with --enable-unicode.  Mention using
1589   sudo for installing on Unix.
1591 * In the manual, replace the instructions for building from source with a
1592   pointer to the clearer instructions in INSTALL.
1594 * In the manual, make it clear that installing with administrator rights
1595   also applies to newer platforms than XP.
1597 * doc/TODO.htm: Update.
1599 Changes in 1.2.0 (2011-09-20):
1601 * Translation updates for Catalan, French, Romanian, Spanish, Slovak, and US
1602   English.
1604 * tests/smoke.tst: aven no longer requires an X display for --help or
1605   --version, so replace skip of this check with a check that this remains the
1606   case.
1608 * We now use the standard .po and .pot file formats for storing translations
1609   (rather than the Survex-specific messages.txt format), and then translate
1610   these into Survex's .msg format.
1612 * (Unix version): Move survex man page to section 7 (since it isn't documenting
1613   an actual command).
1615 * (Unix version): Write each generated man page to a temporary file, then
1616   atomically rename, to avoid leaving an empty or partial man page behind if
1617   docbook-to-man dies (1.1.16 had an empty cad3d.1, and we want to avoid a
1618   recurrence of that).
1620 * (Unix version): Default to installing docs into /usr/share/doc/survex rather
1621   than /usr/doc/survex.
1623 * aven:
1625   + Fix handling of accented characters in the survey pane.
1627   + Aven icon redrawn in SVG format - it's now a vector image which looks
1628     nicer at larger sizes.
1630   + Explicitly request double-buffering, which seems to be needed for systems
1631     with GLX >= 1.3.
1633   + Fix crash while trying to load certain .3d files.
1635   + Movie export code updated to work with more recent versions of FFmpeg.
1636     Currently this is disabled in Microsoft Windows builds, pending getting the
1637     required libraries set up for building releases.
1639   + Reporting of errors during movie export improved.
1641   + Force playback speed to "x1" during movie export.
1643   + Use stock IDs for buttons where appropriate - such buttons may now be
1644     rendered with icons on some platforms.
1646   + If a label isn't valid UTF-8, treat it as CP1252 (the Microsoft superset of
1647     ISO8859-1).
1649   + (Unix version): Remove special handling for toggling "full screen" on wxGTK
1650     as it's no longer required with modern versions.
1652   + Don't redraw the survey on every mouse movement in the survey pane unless
1653     the measuring line is (or just was) active.  (ticket #17)
1655 * cavern:
1657   + Drop "non-fatal" from the report of how many errors there were at the end
1658     of the run - it just confuses users - we won't even get here if there's a
1659     fatal error!
1661   + Add --3d-version option to allow the user to specify the version of the 3d
1662     format to output.  (ticket#21)
1664 * img library:
1666   + Make the highest and lowest valid values for img_output_version available
1667     in img.h as IMG_VERSION_MIN and IMG_VERSION_MAX.
1669 * (Mac OS X version): Fix buildmacosx.sh script to check where the temporary
1670   volume actually gets mounted.  Fix URL for downloading wxWidgets.
1672 Changes in 1.1.16 (2011-05-16):
1674 * Translation updates for German, Spanish, Italian, Portuguese, Brazilian
1675   Portuguese, and US English.
1677 * Use horizontal ellipses character rather than '...' and right arrow character
1678   rather than '->' where these characters are available.
1680 * (Unix version): Link with -lGL, if it exists, to support linking with gold or
1681   GNU ld --as-needed (Debian bug #615781).
1683 * img.c:
1685   + Fix code typo for IMG_API_VERSION == 0 case.
1687   + Fix code typo in code used when IMG_HOSTED isn't defined.
1689 * doc/TODO.htm: Remove entries which have now been done.
1691 * (Microsoft Windows version): aven: We now include all the available
1692   translations for messages from wxWidgets, which means that standard widgets
1693   will appear translated where available even if Survex messages aren't
1694   translated.
1696 Changes in 1.1.15 (2010-10-15):
1698 * aven:
1700   + In the cavern log window, change the "Rerun" button to "Reprocess" to
1701     follow terminology in manual and elsewhere.  Fixes ticket#15.
1703   + When displaying output from cavern, don't update the window after every
1704     line, but only when we don't have data from cavern pending.  Hopefully
1705     addresses ticket#12.
1707   + If we aren't using GL_POINTS for blobs, draw them using a series of
1708     abutting lines rather than with gluDisk which is faster and gives a
1709     consistent shape.
1711   + Check whether blobs and crosses actually render correctly as points/point
1712     sprites, and if they don't, fall back to drawing them with lines.  The
1713     best method is cached on disk, and rechecked automatically if the graphics
1714     hardware is changed or the drivers upgraded.
1716   + Fix non-USE_FNT case to work again (it's limited to ISO-8859-1 characters
1717     though, so we still enable USE_FNT by default).
1719   + Don't offer "All files" wildcard in presentation save dialog.
1721   + (Microsoft Windows): Handle filenames with non-Latin1 characters in in
1722     more places.
1724   + (Microsoft Windows): Quote filenames with spaces and metacharacters in
1725     when running cavern from aven.  Fixes ticket#11.
1727 * editwrap: (Microsoft Windows): Handle filenames with non-Latin1 characters.
1729 * diffpos: Handle files with duplicate labels in better - extend generates
1730   duplicate labels when it breaks a loop.
1732 * Enable eswap-break testcase now that diffpos handles duplicate station names.
1734 * New v7 of .3d format which stores survey dates as number of days since
1735   January 1st 1900, so we now support dates from 1900-2078 (rather than
1736   1970-2037) with a smaller file size.  The img API is now versioned - you
1737   can select the new "version 1" by compiling with -DIMG_API_VERSION=1, which
1738   gives the survey dates in days in days1 and days2 instead of as time_t
1739   values in date1 and date2.  Fixes ticket#14.
1741 * Consistently use http://survex.com/ rather than http://www.survex.com/ - the
1742   former has been the canonical name for some time, with www.survex.com just
1743   redirecting to it.
1745 * (Unix version): Use unlocked file I/O if available, which can be much faster
1746   in some cases (we don't need the locking as we don't do multithreaded file
1747   I/O).
1749 * (Mac version): Fix compilation failure due to clash with Point in Mac OS X
1750   headers.
1752 * (Mac version): buildmacosx.sh now works again.
1754 * Most tests weren't actually running any testcases (looks like a sh
1755   portability issue).  This is now fixed, and fortunately all tests still pass.
1757 * Include the extra .isl translation files for Innosetup in the source archive.
1759 Changes in 1.1.14 (2010-07-26):
1761 * Restore compatibility with wxWidgets 2.6 (1.1.13 required wxWidgets 2.8).
1763 * aven:
1765   + After processing survey data, if there were warnings or errors, add a
1766     "Rerun" button to allow easy reprocessing after fixing problems.  If there
1767     were only warnings, also add an "OK" button to allow moving on to viewing
1768     the processed survey data (fixes ticket#13).
1770   + Optimise updating of the cavern log window (hopefully fixes ticket#12).
1772   + Fix links in cavern log window to link from exactly '<file>:<line>' (and
1773     not the ': ' after), and to make the title for the terminal the
1774     warning/error message.  Avoid false positives by checking that '<line>' is
1775     a number.
1777   + Don't double escape the contents of href and target in links in the cavern
1778     log window.
1780   + Improve handling of the splitter window, fixing behavioural glitches in
1781     various cases.
1783   + Highlight stations matching any current search when a file is loaded.
1784     (ticket#9)
1786   + (Mac version): Fix build issue due to Mac OS X polluting the global
1787     namespace with its own "Point" class.
1789   + (Unix version): The Gnome print dialog has its own preview window so
1790     suppress ours if using the Gnome one.
1792   + (Unix version): Link aven with -lGLU which SuSE Linux needs.
1794   + (Microsoft Windows version): Fix handling of a double-click on the survey
1795     tree when built with wxWidgets >= 2.8.11.
1797 * cavern: Report relevant file and line number for three warnings which didn't
1798   give them before.
1800 * (Unix and Mac versions): configure: Update the wx-config probing code -
1801   wxmac-config etc aren't present with newer wxWidgets versions so there's no
1802   point looking for them now.
1804 * (Mac version): buildmacosx.sh: This script builds a diskimage with Survex in
1805   for easy installation.  Update it to work with the latest Survex versions
1806   (use WX_CONFIG not WXCONFIG; use a Unicode build of wxWidgets; if building a
1807   private wxWidgets, use 2.8.11 not 2.7.0-1).
1809 * manual:
1811   + Correctly capitalise "GTK".
1813   + Note that on Linux we only regularly test builds with the GTK+ version
1814     (change taken from 1.0).
1816 * Fixed the cad3d man page, which was an empty file in 1.1.13.
1818 Changes in 1.1.13 (2010-06-16):
1820 * Say "wxWidgets" instead of "wxWindows" consistently.
1822 * img.c: Fix small memory leak (filename_opened member).
1824 * cad3d, aven: Fix export to SVG when a label contains a '%' character.
1826 * aven:
1828   + wxWidgets 2.6.0 or newer is now required.
1830   + A "Unicode" build of wxWidgets is now supported.  An "ANSI" build may still
1831     work but hasn't been tested recently (all packaged versions of wxWidgets
1832     seem to be Unicode now).
1834   + Fix potential uses of uninitialised variables which may have been causing
1835     occasional glitches when loading a file on start-up.
1837   + Improvements to the handling of the font used for plotting labels and other
1838     text on the survey pane:
1840     - Loading the font file is more efficient.
1842     - Character spacing is improved.
1844     - Default font is now anti-aliased.
1846   + "About" dialog:
1848     - Add "Copy" button to copy the system info to the clipboard for easier
1849       bug reporting.
1851     - List OpenGL extensions last, since there are usually lots of them with a
1852       modern gfx card.
1854     - Fix 100% CPU usage while the "About" dialog is open.
1856   + Processing .svx files:
1858     - Passing a .svx file on the command line now works better.
1860     - Put the survey data log window in a splitter in the usual frame rather
1861       than opening a separate frame for it.
1863     - Auto-scroll the log window until we've reported a warning or error.
1865     - Fix small memory leak.
1867   + The presentation filename now defaults to using the basename of the
1868     currently loaded dataset, but we always prompt before we first save with
1869     such a name.
1871   + Reduce memory usage when saving a screenshot.
1873   + Allow "Toggle Fullscreen" to work even if no survey is loaded now that we
1874     persist the window size (and maximised or fullscreen state) between
1875     invocations.
1877   + Fix reporting of OpenGL errors.
1879   + Fix glitches when tilting while looking East.
1881   + Added Portuguese and Slovak translations of wxWidgets messages.
1883 * Documentation:
1885   + Rationalise manual formats - replace PostScript with PDF and drop RTF.
1887   + Drop the "alternative manual formats" self-extracting zip file - people
1888     will generally just want one of the formats, so downloading several
1889     together isn't very useful.
1891   + 3dformat.htm: Update for v6 format (thanks to Mike McCombe).
1893   + GPL.htm: Replace HTML version of licence with a link to the version on
1894     the FSF website.
1896   + ChngeLog.htm: Stop generating an HTML version of the ChangeLog - it's too
1897     low level to be of interest to non-developers, and developers can look at
1898     the source code.
1900 * (Unix version): configure: New preferred name for specifying wx-config script
1901   is WX_CONFIG.  WXCONFIG still supported for compatibility.
1903 * (Linux version): Source RPM package dropped as you can just build an RPM
1904   package from the source tarball.
1906 * (Microsoft Windows version): The installer is now created with a newer
1907   version of InnoSetup, which gives a 10% smaller download.
1909 Changes in 1.1.12 (2007-02-07):
1911 * aven:
1913   + Remember the window size or maximised/fullscreen state between invocations.
1915   + Add options dialog to "Export" similar to the one for "Print".
1917   + The "number of pages required" in the print dialog now updates when you
1918     change what is to be shown (underground legs/surface legs/station
1919     names/crosses).
1921 Changes in 1.1.11 (2006-11-25):
1923 * Updated Czech, Spanish, and Slovak translations.
1925 * (MacOS X version): Assorted OS X specific tweaks and fixes.
1927 * aven:
1929   + Pick a smaller and clearer font for labels.
1931   + Fix character spacing.
1933   + Tweak display of bearing and elevation angles to look nicer with
1934     proportional fonts.
1936   + Use the title from the 3d (or plt, etc) file for the window title
1937     rather than the filename.
1939   + Show distances to 2 decimal places rather than the nearest integer.
1941   + Only consider underground legs when calculating the depth bands and
1942     depth colouring.
1944   + Add "Colour by Error".
1946   + Add entry for "white" in date and error keys.
1948   + When setting the view to a single point, don't change the scale.
1950   + If reloading the same file, don't change the view
1952   + Fix filetypes selector in open dialog.
1954   + Fix the charset we use for aven in certain cases.
1956   + Call msg_init before using msg_lang or it won't ever be set!
1958   + Pass wx the full language code to initialise the C library locale.
1960   + Fix bug in generating prefix tree view which could lead to a bogus
1961     leading dot on some survey names (bug probably introduced in 1.1.10).
1963   + "New Presentation" now ensures that the side panel is open
1965   + Fix updating of cached opengl lists when the view is reset to the
1966     default.
1968 * Ignore LANG if it starts with a digit to avoid problems with bogus value for
1969   LANG which AutoCAD installation seems to set on MS Windows.
1971 * (Unix version): configure: Allow SGMLTOOLS and DOCBOOK_TO_MAN to be
1972   specified.  Either/both can be set to ":".
1974 * dump3d: Report unknown (to dump3d) codes returned by img.
1976 * img library: Flag all stations as underground in the old "ASCII" .3d format.
1978 Changes in 1.1.10 (2006-07-14):
1980 * aven: Clicking on a survey name in the survey tree now highlights it in
1981   the map view.  Double-clicking zooms the view to show the clicked survey
1982   highlighted.  Clicking the root clears the highlighting and double-clicking
1983   the root restores the default view.  To expand/collapse a branch, click
1984   on the "[+]" or "[-]" icon to the left of the survey name.
1986 * aven: The measuring line can now measure to anywhere in plan or elevation
1987   view (not just to a station!)  In plan view the horizontal distance and
1988   bearing are shown, while in elevation view the vertical distance is shown.
1990 * aven: Moving the mouse over a station in the survey view now highlights
1991   that station in the survey tree (though it may not be visible if the
1992   survey(s) it is in aren't expanded).
1994 * aven: Clicking on a station to centre the view now moves the mouse pointer
1995   to the new location of the station (except on Mac OS X where this isn't
1996   allowed).
1998 * aven: Fix which presentation toolbar buttons are shown as depressed.
2000 * Fix infinite loop reading 3d files with LRUD data (bug introduced in 1.1.9).
2002 * vim files are now installed with the correct paths (bug introduced in 1.1.9).
2004 Changes in 1.1.9 (2006-07-04):
2006 * (Unix version): Install desktop files for aven and svxedit contributed to the
2007   Ubuntu package by Phil Bull, and corresponding pixmaps.
2009 * Fix img to filter out cross-sections which don't match the subsurvey (if
2010   specified).  The API now returns img_XSECT_END to mark the end of a
2011   passage rather than setting a flag on the last img_XSECT of the passage.
2013 * Enhance integration with the vim editor - this can now colour .err files, run
2014   cavern from vim and parse error output, and run aven from vim.  Tweak the
2015   existing vim mode for .svx files to fix a few minor bugs and add support for
2016   the new "*data passage" style.
2018 * aven: fix drawing of the "blob" end of the measuring line on graphics cards
2019   which can't draw large enough blobs for us.
2021 * aven: sort out confusion about what encoding everything is in which means
2022   that the distance measured by the measuring line actually gets displayed
2023   and also fixes problems with empty menu items in non-English locales in
2024   some cases.
2026 * aven: redraw grey background after a menu is closed over the aven window
2027   with no survey loaded.
2029 * aven: fix bug which caused printing to crash (introduced in 1.1.8).
2031 * aven: avoid crash on some machines when opening "About" dialog before having
2032   loaded a survey.
2034 * aven: Translate "Plan" and "Elevation" buttons in print view dialog.
2036 * (Unix version): aven: Fix character set handling of cavern output.
2038 * cavern: Report an error if a cross-section is specified for a station which
2039   doesn't exist.
2041 * Updated French and Italian translations.
2043 * (Unix version): aven: Fix "Can't open message file `en_US' using path
2044   `${prefix}/share/survex'" error.
2046 * Fix bug in 3d file reading on 64 bit platforms when used in STANDALONE mode
2047   (doesn't affect Survex itself, but other applications which use img.c should
2048   update their copy).
2050 * (Unix version): Add checks that wxWidgets is a non-unicode version (wx 2.6
2051   and later are caught by configure, whereas older wx versions are caught when
2052   trying to compile).
2054 Changes in 1.1.8 (2006.06.30):
2056 * Drop support for building with wxWidgets versions prior to 2.4.0
2057   (which was released on 2003-01-07).
2059 * aven: Printing through aven now uses settings from the "[aven]" section
2060   of print.ini, and support for hierarchical sections (using "like=")
2061   has been disabled.
2063 * aven: Change mouse actions to be compatible with those in Survex 1.0.
2064   The mousewheel now zooms in/out (it doesn't do anything in 1.0) and
2065   left drag is now smart about not rotating and zooming at the same
2066   time.
2068 * aven: Highlighting stations now happens as you type, and pressing
2069   "Enter" or clicking the "Find" button now pans and zooms to show the
2070   highlighted stations.
2072 * aven: Left-clicking away from a station now cancels measuring line.
2074 * aven: Setting view to North, South, East, or West is now animated like
2075   the tilt from plan to elevation.
2077 * aven: Fix presentation saving to also write "." for decimal points and
2078   presentation loading to accept either "." or ",".
2080 * (Unix version): aven: Add text for all toolbar items so that aven
2081   will work with the Gnome desktop preference for displaying toolbars as
2082   icons with text or just text (wxWidgets needs fixing first though).
2084 * (Unix version): aven: Remove the ability to detach the menu bar (yell
2085   if you actually used it and I'll restore it!)
2087 * aven: Add "all survey files" option to the "open file" dialog.
2089 * (MS Windows version): aven: Fix cursor keys to pan survey.
2091 * (MS Windows version): Built with wxWidgets 2.6.3 instead of 2.6.2.
2093 * (MS Windows version): Fix installer to work on Windows 2000 or XP if
2094   run by an unprivileged user.
2096 * (MS Windows version): Upgrade to the latest version of InnoSetup (the
2097   installer builder we use) and include new installer translations for
2098   UK English, Spanish, Brazilian Portuguese, Italian, Romanian, and Slovak.
2100 * (MS Windows version): aven: Include Catalan and Brazilian Portuguese
2101   translations of messages for wxWidgets (the GUI library we use).
2103 * aven: Disable "Highlight exported points" if there aren't any.
2105 * Updates to French translation from Michel Bovey.  Also updates to German,
2106   Italian, Catalan, Spanish, and Romanian translations.
2108 * (Unix version): test suite: fix smoke test to pass even without X running
2109   (it was meant to but the code had a bug).
2111 * aven: Check if OpenGL is available and exit cleanly with a helpful error
2112   if it isn't.
2114 * (Unix version): aven: Fix --help and --version to work without a working
2115   X display (provided it's built with wxWidgets 2.5.1 or newer).
2117 * aven: Automatically select the presentation tab of the notebook when the user
2118   selects "New Presentation" or "Open Presentation".
2120 * aven: Fix "Delete" in the presentation list to not get passed on (and so not
2121   reset to default view as well).
2123 * aven: Fix Ctrl+Insert in the presentation list not to segfault if the list is
2124   empty.
2126 * aven: Fix Cursor Up and Down in the presentation list to move the highlight
2127   up and down instead of being passed on and moving the survey.
2129 * aven: Improve SVG output compatibility.  Tested with Mozilla Firefox 1.5,
2130   Adobe's SVG browser plugin, Gimp 2.2.8, Gqview 2.0.0, Opera 8.5,
2131   Safari 2.0.3, and InkScape 0.42.
2133 * aven: Put a 5mm border around exported SVG files to allow for station markers
2134   and non-zero width lines.
2136 * aven: Fix crash when exporting as SVG or Sketch if labels or surface data
2137   was turned on.
2139 * aven: Actually close the file we're exporting which fixes problems with it
2140   not always being fully written.
2142 Changes in 1.1.7 (2005.10.18):
2144 * cavern: Add validity checking for dates in *date commands (with feature
2145   test in testsuite).  A date entered as just "year" or "year.month" now
2146   becomes a date range for the relevant period (previously it became a single
2147   date near the middle of that period).
2149 * extend: Fixed 2 uninitialised flags (should fix erratic behaviour on
2150   with MS Windows).
2152 * extend: Default output name for a file called input.3d is now input_extend.3d
2153   rather than just extend.3d (which was annoying if you wanted to extend
2154   several surveys in the same directory).
2156 * aven: OpenGL 2.0 always includes support for point sprites so rework
2157   our check for them to include that knowledge.
2159 * aven: Regenerate depth bar if user switches to/from metric units.
2161 * aven: Don't clear the "there" mark just because the mouse pointer has
2162   moved off a station.
2164 * aven: When processing a .svx file, put the resultant .3d file in the
2165   same directory (since that's where we then try to load it from).
2167 * aven: Fix labelling of date colouring on 32 bit platforms.
2169 * aven: If "colour by date" is on and we load a survey with no date info
2170   (or all surveyed on the same date) then set "colour by none".
2172 * aven: Make the error dialog modal and remove a signal handler once it
2173   has fired to prevent endless (or seemingly endless) cascades of error
2174   dialogs.
2176 * aven: Enforce a minimum object volume diameter of 1m to avoid problems
2177   if a survey file with only one station in is loaded.
2179 * aven: Fix problems with indicators disappearing when we're drawing
2180   blobs and/or crosses the slow (but always supported) way.  (Problem
2181   introduced in 1.1.6).
2183 * (Unix version): aven: Really stop setting extra toolbar margin when using
2184   GTK2.0.  The attempt to fix this in 1.1.3 failed because __WXGTK12__ is
2185   set for GTK+ 1.2 or *any later release* so is true for GTK+ 2.0 too!
2187 * (Unix version): aven: Add details of which of wxGTK, wxMotif, and wxX11
2188   we've been compiled with, and which GTK+/Motif version where appropriate.
2190 * (Unix version): Fixed build on Fedora Core 3.
2192 * documentation: Updates to 3d file format specification from Mike McCombe.
2194 Changes in 1.1.6 (2005.10.10):
2196 * (MS Windows version): Distribution is about a third smaller than 1.1.5
2197   (mostly because mingwm10.dll is no longer required).
2199 * aven: If aven is asked to load a .svx, .dat, or .mak file, run cavern on
2200   it, showing cavern's output in a window (with errors and warnings clickable
2201   to load the offending file into an editor), and then loading the resulting
2202   3d file.
2204 * aven: Added "Colour by Date" option.
2206 * aven: Disable "Colour by Depth" option if there's no elevation variation.
2208 * aven: Don't crash if trying to load a survey with no elevation variation.
2209   Instead turn off depth colouring.
2211 * aven: Export as HPGL added.
2213 * aven: Improved update of mouse coordinates and measuring line (thanks to
2214   Martin Green).
2216 * aven: Show the coordinates of either the mouse pointer or the nearest
2217   survey station to it (if there is one near enough).  Showing both was
2218   confusing and meant the status bar overflowed on smaller displays.
2220 * aven: When printing an extended elevation, don't show bearing and elevation.
2222 * aven: Don't lock "flat" surveys which aren't extended elevations - a
2223   flat survey with LRUD data isn't flat any more!
2225 * aven: When we have to draw blobs and crosses the slow way (because the
2226   graphics hardware doesn't support the fast way), draw them so that they
2227   should appear at the correct depth into the 3D scene instead of on top
2228   of everything else.
2230 * aven: Make "play presentation backwards" icon green to match the other
2231   presentation icons.
2233 * (MS Windows version): aven: Mouse clicks on the survey view now set the
2234   keyboard focus there.
2236 * (MS Windows version): aven: Fix first redraw of a newly loaded survey.
2238 * (MS Windows version): aven: Fix redrawing of measuring line.
2240 * cavern: Store dates for img_XSECT.
2242 * cavern: Fixed small one-off memory leak if you specify -o more than once.
2244 * (Unix version): Check environmental variable LC_MESSAGES when deciding what
2245   language to use for messages.
2247 * (MS Windows version): "Print" on a 3d file now prints through aven rather
2248   than the separate printer driver (Unix has done this for some time).
2250 * Removed old printer drivers.
2252 * img library: When creating a 3d file, ignore img_XSECT if we've been asked
2253   to write a file format version which doesn't support it.
2255 Changes in 1.1.5 (2005.09.20):
2257 * (MS Windows version): aven: Fixed crash on start-up (introduced in 1.1.4).
2259 * aven: Make blobs round like they are in Survex 1.0.
2261 * aven: If the graphics drivers don't support drawing blobs using OpenGL
2262   point markers, fall back to drawing filled circles.
2264 * aven: If the graphics drivers support it, draw crosses as texture mapped
2265   OpenGL point markers which is much faster.
2267 * aven: Cross size increased to match Survex 1.0.
2269 * aven: We must update which blobs are displayed if display of surface or
2270   underground legs is toggled.
2272 * cavern: Fix handling of a *solve followed by survey data, none of which is
2273   attached to the previous data.
2275 * cavern: Fixed "No survey data" error when a *solve is followed by another
2276   *solve (or the implicit solve at the end of processing) with no data between
2277   them.
2279 Changes in 1.1.4 (2005.09.19):
2281 * aven: Added Aven's icon to the "About" dialog.
2283 * aven: Use localised character for the decimal point (e.g. "," in most
2284   continental European countries).
2286 * aven: Previously the survey tree would get focus and then take keypresses
2287   (e.g. "P", "L", "Delete").  Now we pass most keypresses across so they
2288   operate on the cave, and transfer the input focus across when we do.
2290 * aven: Make pressing "Return" in the tree control expand/collapse a subtree.
2292 * aven: Speed up intialisation by delaying creation of OpenGL lists until
2293   they're needed.
2295 * aven: Added Mark Shinwell's bounding box with shadow of the survey.
2297 * aven: Disable the "Tubes" button/menu item when there's no LRUD data.
2299 * aven: Reworded "Restore Default Settings" as "Restore Default View".
2301 * (Unix version): aven: Set sensible default margins for printing and preserve
2302   any margin values the user specifies between runs (previously margins
2303   defaulted to 0 each time aven was run).
2305 * Documentation: Document *DATA PASSAGE in the manual.
2307 Changes in 1.1.3 (2005.09.07):
2309 * (Microsoft Windows version): Fixed build problems.
2311 * cavern: Allow OMIT character (-) for left/right/up/down.
2313 * aven: Remove an unnecessary menu separator.
2315 * aven: Fix "Find" and "Hide" toolbar buttons to work with GTK2.0.
2317 * aven: Make the tooltip for "Hide" show the number of found stations.
2319 * aven: If * or ? is used in a glob-style pattern, force a non-substring match.
2321 * aven: Enable "New Presentation" when there's a 3d file loaded, rather than
2322   when there's a presentation loaded.
2324 * aven: Make entrances green in side panel tree list to match green blobs used
2325   in cave view.
2327 * aven: Don't show surface labels if we're not showing surface data, etc.
2329 * aven: Merge "Start Rotation" and "Stop Rotation" into "Toggle Rotation" and
2330   make "Space" the key for this.  Keep Return working "Stop Rotation" so
2331   existing users are happy, but don't advertise it.
2333 * aven: Normalise filename by adding any extension used, and use the normalised
2334   filename for file history and window title.
2336 * (Unix version): aven: Stop setting extra toolbar margin when using GTK2.0
2337   as the toolbar buttons already have a sensible margin - the extra margin is
2338   only needed with GTK1.2.
2340 * aven: Fix handling of plumb legs in tube model.
2342 * aven: Fixed swapped L and R in tube model.
2344 * extend: Preserve UD cross-section information in extended elevation.
2346 * extend: Add new messages for John Pybus' enhancements.
2348 Changes in 1.1.2 (never formally released):
2350 * Added support for LRUD data in .svx files, in .3d files, and aven can
2351   now load and display it on screen and on printouts.  The ability to "fake"
2352   LRUD data in aven is gone for now but will reappear in some form later.
2354 * cavern: Removed support for writing Chasm's 3dx format.  We're going to
2355   fold any desirable missing chasm functionality into aven.
2357 * aven: Rearranged mouse actions as discussed on the mailing list.  Added
2358   cursors for each different mouse action to help the user learn what each
2359   does.  Also added cursors for the "compass" and "clino" as well as the
2360   scalebar to suggest to the user that they can be dragged to change the view.
2362 * (Unix version): aven: Don't segfault if LANG isn't a known language.
2364 * tests/smoketest.tst: If X windows is running, check that we can run aven
2365   with --help and --version.
2367 * tests/cavern.tst: Fixed cavern.tst to warn if it is skipping a test because
2368   no results are listed for it.  This revealed that there was a "newline" test
2369   which should have been called "badnewline", and was a broken testcase too!
2370   Fixed all these problems.
2372 * cavern: Applied Simeon Warner's patch for handling backcompass, backclino,
2373   and omitted forward compass/clino readings in Compass DAT files.  Added
2374   a feature test for this to the testsuite.
2376 * It no longer makes sense to have an option not to build aven or to build aven
2377   without OpenGL so remove old machinery for this from configure and the
2378   sources.
2380 * (Unix version): configure: Check if "-lXxf86vm" is needed.
2382 * configure: Better output for strcasecmp test.
2384 * aven: Fix crosses to work much better.  Not a total fix - their position
2385   in the Z buffer isn't correct and they're rather slow to plot.
2387 * aven: Don't regenerate the hittest grid every time the mouse moves while
2388   animating, which solves the mysterious pausing effect (thanks go to Martin
2389   Green for spotting this!)  Also clear all the status bar coordinates when
2390   animating.
2392 * aven: Sort out clashing menu shortcuts in some languages.
2394 * aven: Fixed compilation problem on x86_64
2396 * SPUD: Pruned out stuff which has been done or which is not actually relevant
2397   to this branch.
2399 * Merge various changes from 1.0 branch:
2401   + aven: Port over "printing from aven" functionality.
2403   + aven: Port over "export as" functionality,
2405   + Add David Loeffler's vim mode for .svx files.
2407 * aven: Fix check for whether a label is behind us in perspective view.
2409 * aven: Don't use an opengl list for drawing the indicators - we typically make
2410   a new list each time we plot them anyway.
2412 * Remove lingering traces of support for RISC OS and pre-386 MSDOS
2414 * aven: Set icon on non-Windows platforms too.  This means that with
2415   WindowMaker on Unix you get an icon on the AppIcon by default.
2417 * configure: Update wxWindows checks to handle newer wx versions.
2419 * Make all maintainer perl scripts "use bytes;" to avoid utf-8 double encoding
2420   problems.  They also all require Perl 5.8 now (hopefully this isn't an issue
2421   for anyone building from CVS).
2423 * acinclude.m4: Quote macro name for fix autotools warning.
2425 * Documentation: "tilt up" is "'" not ",".
2427 * aven: Add support for mousewheels (to tilt the cave).
2429 * aven: Fixed twisted transitions to and from pitches in certain cases.
2431 * aven: Pick a sensible initial window size when the user's desktop is spread
2432   over more than one monitor (works best with wx2.5 or newer, but try to do
2433   better with wx2.4 or earlier as well).
2435 * aven: Initialise GfxCore slightly later to avoid visual glitch from notebook
2436   contents being visible before any survey is loaded.
2438 * aven: Allow a coloured texture to be used
2440 * aven: Don't initialise until we have data (to the user, this means the window
2441   is default colour (grey for most systems) not black until a survey is
2442   loaded).
2444 * aven: Fixed weird "shadowed" icons.
2446 Changes in 1.1.1 (2004-10-06):
2448 * (Microsoft Windows version): aven: Hopefully fix loading a survey file at
2449   startup.
2451 * aven: Delay loading the bitmap for the "About" dialog until it is first
2452   needed.  We want start up to be as quick as possible.
2454 Changes between 1.0.32 and 1.1.0 (never formally released):
2456 * NOTE: Survex 1.1.X releases are development snapshots made available for
2457   the purposes of allowing wider testing and getting more user feedback.  Once
2458   the code has stabilised the version number will be raised to 1.2.0.
2460 * aven: Now uses OpenGL for 3d rendering - you may need to install drivers if
2461   you're using Windows 95 - these can be obtained from:
2462   http://download.microsoft.com/download/win95upg/info/1/W95/EN-US/Opengl95.exe
2464 * aven: Solid passages - passage dimensions are currently inferred from
2465   the leg length (pretty effective as you can measure longer legs in
2466   larger passages).  Use of real LRUD data coming soon...
2468 * aven: Depth colouring is now continuously varying.
2470 * aven: Colour by depth can now be turned off (and there's the start of a
2471   framework for properly implementing colour by date, error, etc).
2473 * aven: Find stations moved onto the toolbar and now uses a simple wildcarded
2474   match (? matches any character, * matches any number of characters).
2476 * aven: We now use the status bar for coordinates, distances, etc to make
2477   better use of screen space.
2479 * aven: Full screen mode (F11).
2481 * aven: Perspective view.
2483 * aven: Context sensitive cursor shape - needs more work.
2485 * aven: Mouse actions changed (hopefully they're now more natural, but
2486   you may find the change disorientating - feedback wanted on this).
2488 * aven: Added "presentations" which allow you to set up fly-through paths
2489   and load/save/run them.
2491 * aven: A presentation can be exported as a movie file.
2493 * aven: Added Save screenshot facility.
2495 * aven: Depth fogging option.
2497 * aven: Added Smooth Lines option.
2499 * aven: Added Textured Walls option.
2501 * aven: If a survey has surface legs but no underground legs, default to
2502   showing the surface legs.
2504 * cavern: Dates given to *date are now stored in the 3d file.