[ci] Install pkg-config in debian-stable job
[survex.git] / NEWS
blob70694ac146eaa9d9eede95ffd51b673d454eae7d
1 up to: 06d52d5a6035179b753111474010268a0e59cd12
3 Changes in 1.4.6 (2024-02-??):
5 * aven,survexport: Enable export of surface legs for KML and JSON.  Currently
6   surface and underground legs aren't differentiated in these export formats
7   when both are enabled.
9 * aven,survexport: Fix survey filtering when reading Compass PLT files.
11 * Update build system to eliminate use of obsolete autotools macros.
13 * cavern:
15   + Workaround bug in PROJ < 9.3.0 with projected coordinate systems with
16     northing/easting axis order (such as EPSG:3042) which results in the grid
17     convergence being wrong by about 90°.  Reported by Patrick Warren on the
18     mailing list.
20   + If *declination auto was used before *cs out we would incorrectly calculate
21     the grid convergence as 0.  We now handle this case correctly by
22     calculating lazily when we first read a compass reading, and report an
23     error if the output coordinate system hasn't been set by then.
25   + Compass DAT files:
27     - Surveys which indicate a depth gauge was used for azimuth readings are
28       now marked as STYLE_DIVING in the 3d file.
30     - We now parse the "CORRECTIONS2" field in newer format Compass DAT files
31       which specifies corrections for backbearing and backazimuth.  Previously
32       cavern ignored this field.
34     - The tape correction in Compass DAT files is now handled correctly.  The
35       specified value is in feet, but cavern was incorrectly treating it as
36       being in metres.
38     - We now handle the newer 15 character "FORMAT:" encoding.  Previously
39       cavern wouldn't detect when there were backsights in this case.
41     - We now treat survey date January 1st 1901 as "no date specified" since
42       this is the date Compass stores in this situation, and it seems very
43       unlikely to occur in real data.
45     - In Compass DAT files a dummy zero-length leg from a station to itself is
46       used to provide a place to specify LRUD for the start or end of a
47       traverse (depending if dimensions are measured at the from or to
48       station), and so we no longer issue a warning about equating a station to
49       itself for DAT files.
51   + Compass MAK files:
53     - Use specified datum and UTM zone.  Currently only datum "WGS 1984" is
54       handled here. Other datums could be handled, but the mapping to EPSG code
55       is less simple.  Also it seems Compass supports at least 24 datums but it
56       doesn't document all the strings it uses for them. Please let us know if
57       support for more datums would be useful to you.
59 * aven: Fix OpenGL scaling on high DPI displays with wxWidgets 3.0. Reported by
60   Philip Balister.
62 * manual:
64   + Document Compass support in detail.
66   + Improve NATO mils example.
68 * INSTALL: Clean up text re -dev packages
70 * INSTALL: Add a link to the instructions for building from git.  Reported by
71   Andrew Northall in https://github.com/ojwb/survex/pull/13
73 * doc/TODO.htm: Update.
75 * (Microsoft Windows version): Now using wxWidgets 3.2.4 (was 3.1.6).
77 * Fix compilation warnings from newer compiler versions.
79 * The source code now assumes difftime() is available since it was standardised
80   in C89 and we're not aware of any current platforms which lack it.
82 * img library:
84   + Fix bug handling timestamps before 1970.  In C signed integer division
85     rounds towards zero, which previously resulted in timestamps before 1970
86     getting rounded to the end of the day instead of the start when converting
87     them to a count of days so they'd be off by one day unless the time was
88     midnight.  This affected reading v3-v7 format 3d files with IMG_API_VERSION
89     set to 1 and writing v8 format 3d files with IMG_API_VERSION set to 0 (the
90     default).
92   + Improve Compass PLT support (many of these are Compass features added
93     since Survex's support for Compass was originally added):
95     - Survey dates are now handled fully.  We treat survey date January 1st
96       1901 as "no date specified" since this is the date Compass stores in this
97       situation, and it seems very unlikely to occur in real data.
99     - LRUD data is now translated to img_XSECT and img_XSECT_END.
101     - We now infer img_SFLAG_ENTRANCE for stations where the "Distance From
102       Entrance" field is present and zero.
104     - The shot flag L is now translated to img_FLAG_DUPLICATE.
106     - The shot flag S is now translated to img_FLAG_SPLAY.  A station at the
107       far end of a shot flagged S gets img_SFLAG_WALL set since the Compass PLT
108       format specification says:
110           The shot is a "splay" shot, which is a shot from a station to the
111           wall to define the passage shape.
113     - The shot flag P is now interpreted as marking surface data.  This flag
114       is described as "Exclude this shot from plotting", but the use suggested
115       in the Compass docs is for surface data, and legs flagged with it "[do]
116       not support passage modeling".  Even if it's actually being used for a
117       different purpose, Survex programs don't show surface legs by default so
118       the end effect is at least to not plot as intended.
120     - The d plot command is now supported (previously img failed to parse
121       PLT files using this command) - it's like D but implies the P shot flag.
123     - If a PLT file only uses one datum and it is "WGS 1984" then the UTM zone
124       is converted to the appropriate EPSG code and this is reported as the
125       coordinate system.  Other datums could be handled, but the mapping to
126       EPSG code is less simple.  Also it seems Compass supports at least
127       24 datums but it doesn't document all the strings it uses for them.
128       Files with multiple datums could be handled too, but we'd need to convert
129       coordinates to a common coordinate system in the img library, which would
130       need it to depend on PROJ.  Please let us know if support for more and/or
131       mixed datums would be useful to you.
133     - Duplicate img_LABEL items are no longer returned - this used to happen
134       for stations where more than two shots met within a single survey.
136     - We now infer img_SFLAG_EXPORTED for any station that appears in more
137       than one survey in the PLT file.
139     - We now set flag img_SFLAG_FIXED for any station which is listed as
140       a fixed point in the PLT file.
142     - If there's only one non-empty section name in a PLT file and we aren't
143       filtering by survey, we now report that section name as the title.  If
144       there are multiple different non-empty section names, we still report the
145       basename of the file as before.  If we're filtering by survey, we report
146       the comment for that survey as before.
148     - Fix bug handling PLT with omitted LRUD.  The format specification
149       documents that LRUD may be omitted, though it seems Compass never
150       actually omits it and at least some versions of Compass failed to handle
151       it being omitted too.
153 Changes in 1.4.5 (2023-06-29):
155 * aven: Fix rendering of crosses when drawn as sprites.  Reported by echarlie.
157 * (macOS version): aven: Fix crash in export dialog.  Fixes #133, reported by
158   rixyane.  Thanks to Wookey for testing.
160 * manual: Expand docs on connecting to Compass data.
162 * Minor translation updates.
164 Changes in 1.4.4 (2023-02-03):
166 * aven: Fix red line in clino background to be grey (this was introduced in
167   1.4.3 and was a debugging change accidentally left in).
169 * aven: Accept weird .3d files from Therion which have empty components in
170   station names.  That's not really valid by Survex's definition of station
171   names, but it's not very helpful to reject such files, so just disable the
172   checks that were rejecting this.
174   The result is empty entries in the survey tree, but I don't see what we can
175   really do that's better than that.
177   Reported by Vasily Vl. Suhachev.
179 * aven: Make it more obvious you can enter a custom scale by adding a "..."
180   entry to the scale combobox - selecting this clears the value and gives focus
181   to the combo box text entry. This control has always supported clicking to
182   enter a custom scale, but there wasn't really any indication that this was
183   possible before.  Partly addresses #132, reported by Eric C. Landgraf.
185 * aven: Force export window to resize when the export format is changed as
186   different controls are shown depending on the export format.
188 * aven: Right-align tilt spin control value in print/export dialog to match the
189   bearing spin control.
191 * aven,survexport: Add ability to export as Survex 3d which is useful as you
192   can filter to a subset of surveys, filter out splays, convert from other
193   formats the img library can read, etc.  This feature is a bit rough and ready
194   currently but please report issues.
196 * dump3d: Add --legs option which converts MOVE and LINE to a single LEG line
197   per leg with the from and to coordinates.  Tools which parse dump3d output
198   should find this easier to process as it avoids having to track a "current
199   position".
201 * Update manual to have a complete list of quantities which *calibrate accepts.
202   Reported by echarlie
204 * cavern.tst: Fix testsuite to work with SOURCE_DATE_EPOCH set.
206 Changes in 1.4.3 (2022-05-17):
208 * aven: Much improved support for HiDPI monitors on all platforms.
210 * aven: When started without a file make sure the window has focus so menu
211   accelerators and shortcuts work without clicking on the window.
213 * aven,survexport: DXF export now puts splays in a separate layer and uses a
214   dotted linetype for them.  Patch from echarlie, see #60.
216 * Improved survexport man page to include command line options and a short
217   note about DXF export.  Patch from echarlie.
219 * Minor translation updates.
221 * (Unix version): aven: Fix handling of EGL-based wxGLCanvas (which wxGTK 3.1.5
222   has).  Fix a build failure and don't force X11 (as the EGL-based wxGLCanvas
223   works on Wayland).
225 * (MacOS version): aven: Fix hang on startup without a file.  Fixes #120,
226   reported by Enrico Fratnik.
228 * (Microsoft Windows version): Now using wxWidgets 3.1.6 (was 3.0.5).
230 * img library: Support reproducible builds which create .3d files by not
231   embedding a timestamp if environment variable SOURCE_DATE_EPOCH is set.
232   Requested by Martin Budaj.
234 Changes in 1.4.2 (2022-02-25):
236 * aven: Fix to be compatible with FFmpeg 5.0.
238 * Improve docs for *cs and *declination.
240 * cavern: Fix "*declination auto" not to crash when built with PROJ < 8.1.0.
241   Bug introduced in 1.4.0.
243 * cavern: For each `*declination auto` command cavern now reports an "info"
244   message showing the range of calculated declination values and the dates at
245   which the ends of the range were obtained, and also the grid convergence
246   (which doesn't vary with time).  Fixes #92, reported by Rob Eavis.
248 * cavern: If any of the N-S, E-W or U-D ranges includes an anonymous station
249   then also report the range in that direction excluding anonymous stations.
250   Patch from Thomas Holder.
252 * cavern: The error from a bad `*cs custom` command now highlights the quoted
253   string properly.
255 * cavern: "FIX command with no coordinates - fixing at (0,0,0)" is now an
256   "info" rather than a "warning".  It's not really reporting a problem and the
257   ability to omit the coordinates is a deliberate feature.  It is useful for
258   the user to know where the "*fix" without coordinates is if they want to
259   change the survey to be in real coordinates, so an "info" diagnostic is a
260   good fit.  This also means aven will no longer stay on the log view after
261   processing a dataset which fixes without coordinates.
263 * cavern: If "*fix" is used twice with no coordinates we no longer say
264   "FIX command with no coordinates - fixing at (0,0,0)" right before:
266   error: Already had FIX command with no coordinates for station "x"
268 * cavern: Include errors in Compass .mak files now report the error in the line
269   where the included filename is actually specified.
271 * cavern.tst: Add test coverage for warnings for *entrance and *export with
272   a station which doesn't exist otherwise.
274 * aven/survexport: Change JSON export to be valid JSON.  This means the output
275   has changed incompatibly, but it wasn't valid JSON before which suggests
276   nobody was actually successfully using it. Fixes #128, reported by Pawczak.
278 * aven.tst: Skip one testcase on macos as it seems to hang, at least when
279   running on the Continuous Integration system.
281 * (Microsoft Windows version): The installer is now generated with a much
282   newer version of Innosetup.  Most notably, it now supports installing as a
283   non-admin user.  This also means Microsoft Windows Vista is now the minimum
284   supported version but 2000 and XP are both many years out of support anyway.
286 * (Microsoft Windows version): The coordinate system database for PROJ is
287   now included so "*cs" now works (broken since 1.4.0).
289 * Chinese translation updates from Qingqing Li.
291 * Building from source now requires a compiler with support for C99.  C99
292   seems to be universally supported by compilers now so we don't expect this to
293   inconvenience anyone.
295 Changes in 1.4.1 (2021-11-08):
297 * This release should work with any PROJ version >= 6.2.0.
299 * cavern.tst: Fix to actually run tests when building outside the source
300   tree.  Previously files for testcases weren't found, and tests were skipped
301   with a warning, which lead to 1.4.0 being released with two failing testcase.
302   Fix to find the files, and make not finding them an error.
304 * cavern.tst: Fix testcases gpxexport and require_fail which were failing
305   in 1.4.0.
307 * 3dformat.htm: Document that coordinate system can be ESRI:<number>.
309 Changes in 1.4.0 (2021-11-06):
311 * New release series to mark that Survex now uses the new PROJ API, and
312   requires PROJ >= 7.2.0.  Survex 1.2.x will continue to support PROJ < 8
313   (and won't support newer PROJ versions).  Fixes #102, reported by Bas
314   Couwenberg.
316   Due to these changes, PROJ will now convert directly between coordinate
317   systems where it knows how to, instead of always converting via WGS84.
318   This means conversions may now be more accurate in some cases, and you may
319   notice station coordinates changing - these should be for the better.
321   Also, the vertical datum is now taken into account automatically, and
322   terrain data now aligns much better vertically with surveys.  Fixes #56.
324 * aven: Clicking and holding the left mouse button on the compass or clino,
325   then (while still holding) clicking the right button no longer causes a
326   wxWidgets assertion to fail.  Reported by echarlie.
328 * img library: Rewrite certain proj strings when reading 3d files for
329   better compatibility with newer PROJ versions, where use of proj
330   strings is strongly discouraged.
332   `+init=epsg:` followed by a code number is rewritten to `EPSG:`.
334   `+init=esri:` followed by a code number is rewritten to `ESRI:`.
336   The proj strings which cavern used to put in 3d files for UTM zones and
337   S-MERC are rewritten to `EPSG:` follow by the appropriate code number.
339 * Also install survex.lang for gtksourceview 4. Fixes #125, reported by Martin
340   Green.
342 * Fix missing data style in interleaved example in manual.  Reported by
343   echarlie.
345 * Use jw from docbook-utils instead of sgmltools-lite to process the manual.
346   The sgmltools-lite homepage says it's no longer being developed, and suggests
347   docbook-tools (which Debian packages as docbook-utils) as a replacement.
349 * doc/HACKING.htm: Update Debian packages to install
351 * doc/HACKING.htm: Update details of setting up mingw cross-build environment.
353 * Add simple tests for GPX and KML export.
355 * Expand cavern testcase csbad.
357 * cavern.tst: Parse warning/error counts more robustly.  Previously we'd get
358   confused if the final line just contained an integer, e.g. if we end listing
359   stations not attached to a fixed point.
361 Changes in 1.2.45 (2021-03-09):
363 * Avoid undefined signed shifts in 3d file handling.  Survex itself is only
364   affected on big-endian platforms (so most Linux machine, Microsoft Windows,
365   and current Macs are all OK), but this also affects the img library on all
366   platforms when used in standalone mode as it is in other programs.  Fixes
367   #119, reported by Matěj Plch.
369 * aven:
371   + When reading cavern output for the log window, we need special handling
372     for the case when a chunk of output ends mid-way through a UTF-8
373     sequence.  Previously we lost the first byte of the sequence in this
374     case (and would then show it as an invalid character), but now it is
375     handled correctly.  In practice, most of the cavern log output is ASCII so
376     it's quite possible nobody's ever actually hit this.
378 * testsuite:
380   + Suppress reports of leaks on exit from the LeakSanitiser debugging tool.
381     We know we don't release all memory explicitly on exit since doing so would
382     mean extra work for no reason as the OS reclaims all memory when the
383     process exits.
385 * Convert OLDNEWS encoding from ISO-8859-1 to UTF-8.
387 Changes in 1.2.44 (2021-02-10):
389 * aven:
391   + (Microsoft Windows version): Now using wxWidgets 3.0.5 (was 3.0.4).
393 * cavern:
395   * Add support for quadrant bearings (e.g. N30E).  Patch from echarlie.
397   * Report error if angle units are specified for passage dimension.
398     Previously "*units left degrees" and similar were incorrectly quietly
399     accepted.  Spotted by echarlie.
401   * Fix *data with no parameters to keep the current style and reset any state
402     as documented.  Previously it actually instead ignored any survey data
403     until the next *data command with parameters.
405   * Fix minor memory leak in *data.  We leaked a single memory allocation on
406     "*data default" or an invalid *data command.
408   * Improve test coverage.
410 * survexport:
412   * The check for whether a format supported --elevation, --plan, --bearing and
413     --tilt was inverted.  Reported by echarlie.
415   * Fix reporting of export errors on Microsoft Windows.  Reported by Matic Di
416     Batista.
418 * img library: Fix img_open() when used in other programs.  Patch from Thomas
419   Holder.
421 * configure: Add wx-config-gtk3 to WX_CONFIG search for Arch Linux.  Patch
422   from Thomas Holder.
424 * Improve documentation of interleaved data.  Most notably, we now document
425   that a blank line breaks the current traverse.
427 * Fix typo in manual ('cypolar' -> 'cylpolar').  Patch from Wookey, fixes #117.
429 * Chinese translation updates from Qingqing Li.
431 * Russian translation updates from Vasily Vl. Suhachev.
433 * French translation updates from Jean-Marc and from Wassil Janssen.
435 * Bulgarian translation updates from Wassil Janssen
437 Changes in 1.2.43 (2020-02-28):
439 * cavern: Update to use v13 of the IGRF model for calculating declinations.
440   This was issued in December 2019 and should give slightly more accurate
441   declinations for surveys made since 2010.
443 * aven:
445   + Fix colouring of "not in loop" when colouring by error.  1.2.42 introduced
446     a bug where surveys not in a loop were coloured as if they had zero error.
447     Fixes #111, reported by Bruce Mutton.
449   + Fix handling of grid in export.  The grid was always getting enabled
450     (probably since 1.2.8) even for formats which don't support exporting with
451     a grid.  This resulted in the bounding box being set wrongly for some
452     formats such as SVG, as reported by Richard Knapp on the mailing list.
454   + When showing errors processing the survey data we'd previously crash if
455     cavern incorrectly reported an error as being in a column off the end of
456     the line - now we just ignore the error column in this case.
458   + Support colouring by survey style ("normal", "diving", "nosurvey", etc).
460 Changes in 1.2.42 (2019-09-04):
462 * aven:
464   + Allow colouring by horizontal or vertical error.
466   + (Unix version): Disable scaling for HiDPI displays with GTK3.  The OpenGL
467     code needs work before this will work usefully, so just disable for now
468     (which simulates how things are when using GTK2).
470   + (Unix version): Fix orientation of notebook tabs when build with wxWidgets
471     3.1 development versions.  We want horizontal tab orientation, but were
472     passing a weird flag combination which now results in vertical tab
473     orientation.
475 * When exporting to a format where we support rotation in the horizontal
476   plane (such as SVG), the rotation was incorrectly applied to cross section
477   data (except for the default rotation of zero).  Fixes #108, reported by
478   Richard Knapp.
480 * Add a section to the manual covering the command line tools, and what you
481   might still need to use them for.
483 * Fix compiler warning when building from source with GCC 9.
485 * Consistently refer to macOS not OS X - Apple have renamed it yet again.
487 * (macOS version): Revert the workaround for the crash on macOS 10.14.  The
488   bug we were working around is fixed in git ready for wxWidgets 3.0.5 and
489   there's a backported fix in the homebrew wxmac 3.0.4-2 package, which is how
490   we now recommend people install on a Mac.  Closes #101, reported by floho.
492 * (macOS version): Remove buildmacosx.sh script since installing from homebrew
493   is now the recommended approach.
495 Changes in 1.2.41 (2019-07-10):
497 * aven:
499   + (Microsoft Windows version): Fix error on startup in the pre-built version
500     of 1.2.39 and 1.2.40.  This is a recurrence of the same issue as affected
501     1.2.33 - this time I've patched out the unnecessary check in wxWidgets
502     which causes this problem so it shouldn't recur again.  Reported by
503     Brian Clipstone.
505   + (macOS version): Add work around for crash on macOS 10.14 (not fully tested
506     as I don't have access to a Mac).  Hopefully fixed #101, reported by floho.
508 Changes in 1.2.40 (2019-07-04):
510 * aven: Draw the measuring line ring with an even shape.  Previously the exact
511   shape of the ring varied slightly depending on the exact coordinates, which
512   could be visually distracting once you noticed it.
514 * We were casting a function pointer with a bool return type to the same type
515   but with a void return type.  In practice this probably works fine on most
516   platforms, but it's undefined behaviour and also gives a compiler warning
517   with some compilers.
519 * Fix bug introduce in 1.2.39 with where the "esri" data file for PROJ is
520   installed.
522 Changes in 1.2.39 (2019-06-29):
524 * Support versions 5.x and 6.x of the PROJ library we use for handling
525   conversions between coordinate systems.  Reported by Bas Couwenberg
526   in #102, by Richard Knapp in #103 and by Martin Sluka in email.
528 * (Unix and Mac OS versions): When checking if something is a file or if it is
529   a directory, we no longer treat a symlink as being neither, but instead
530   return an answer based on what the symlink points to.
532 * aven:
534   + Improve handling of hidden splay ends.  Previously, hidden splay ends still
535     served as "targets" for snapping the mouse pointer to, and still got
536     crosses when crosses were enabled.  We don't have a handy flag for "this is
537     the outer end of a splay" and computing that on demand isn't so easy to do,
538     so for now we use the "anonymous station" flag so at least these cases now
539     behave properly for splays to anonymous stations (which is likely to be
540     what people with huge numbers of splays from disto-x, etc are using).  This
541     does mean that anonymous stations on continuation passages will incorrectly
542     also be off when splays are hidden, but that seems an OK trade-off for now
543     and a definite improvement over the previous situation.  The snapping of
544     the mouse pointer was reported by Frank Tully in #105.
546   + Fix typo in export UI (CVS should be CSV).
548 * Documentation:
550   + Add CSV to documented list of survexport output formats.
552   + Fix *declination syntax synopsis - "auto" is a literal string, not a
553     placeholder.
555   + Update PROJ project name and website - the name is now "PROJ" (all caps and
556     no ".4" suffix) and the website is now: https://proj.org/
558 * Install gtksourceview-3.0 language file so .svx files now get syntax
559   highlighting in gedit and other GtkSourceView-based editors.  Patch
560   from Philip Withnall.  Fixes #98.
562 * (Microsoft Windows version): The Survex installer doesn't uninstall the old
563   version when you upgrade, but just overwrites it with the new version.  In
564   1.2.35 cad3d.exe was replaced with survexport.exe, but a user upgrading from
565   an older version would still have cad3d.exe from that old version.  We now
566   remove any old cad3d.exe left over from a previous install in the same
567   location to avoid confusion.
569 * Add a few more message translations.
571 * Fix warnings when built with a C++11 compiler.
573 Changes in 1.2.38 (2019-03-02):
575 * cavern:
577   + Deprecate MILS as angular units.  Survex has long support MILS as an alias
578     for GRADS.  However, this seems to be a bogus definition of a "mil" which
579     is unique to Survex (except that Therion has since copied it) - there are
580     several different definitions of a "mil" but they vary from 6000 to 6400 in
581     a full circle, not 400.  Reported by Andy Edwards.
583   + Fix segfault for *include "".  This isn't useful, but shouldn't crash.  It
584     now reports "file not found" instead.
586   + Use isnan() to check for not-a-number.  This is cleaner, more robust and
587     more efficient than formatting the number as a string and checking for
588     "NaN" or "nan" in the result.
590 * Avoid unused variable warning when compiling from source with modern ffmpeg.
592 * Drop support for wxWidgets < 3.0.  3.0.0 was released over 5 years ago and
593   should be easily available everywhere by now.  I'm no longer easily able to
594   test with wxWidgets 2.8, and this allows a significant amount of cruft to be
595   removed.
597 * (Linux version): survex.spec: Fedora have removed gcc from the default build
598   environment so need to explicitly list it in the BuildRequires tag.  See
599   https://fedoraproject.org/wiki/Changes/Remove_GCC_from_BuildRoot for more
600   information.  Patch from James Begley.
602 Changes in 1.2.37 (2018-11-18):
604 * aven:
606   + Add basic "Colour by Survey" feature.  The colours used aren't currently
607     controllable.
609   + Fix export of splays.  Patch from Thomas Holder.
611   + Fix KML export to avoid invalid geometry when a tube intersects itself.
612     Patch from Robert Jones.
614   + (Unix version): Fix to work under Wayland by forcing the x11 GDK backend
615     for now.  This is a workaround until wxWidgets OpenGL support is updated
616     to work under Wayland.  Reported by Philip Balister.
618   + Fix warnings about using deprecated functions when building movie export
619     code using FFmpeg 4.0.
621 * cavern:
623   + Compass MAK files: Handle fixed point coordinates in feet - previously the
624     units were ignored and the coordinates assumed to be in metres.
626   + Previously the first byte in a MAK file was ignored.  Typically MAK files
627     start with a comment, and since cavern currently ignores lines that start
628     with characters it doesn't understand the meaning of, this bug would often
629     go unnoticed.
631 * survexport:
633   + Fix exporting of passages, walls and cross-sections by running the code
634     aven uses to decide how much to rotate each cross-section.  Previously all
635     cross-sections were aligned West-East.  Reported by Robert Jones.
637   + Default to .pos output if the program name is 3dtopos, and install a second
638     copy (or hardlink under Unix) as 3dtopos.  This provides compatibility with
639     current releases of Tunnel.  Reported by Becka Lawson, Wookey and
640     Stephen Crabtree.
642 * Fix some German translations.  Patch from Thomas Holder.
644 * (MacOS X version): Fix aven-create-app to not delete converted icons.
645   Typo spotted by Robert Jones.
647 * Improve documentation for *team.  Document the requirement to quote names
648   unless a person is identified by just one name.  Document that the roles are
649   optional, as that information may not have been recorded, and to align with
650   therion's team command.
652 Changes in 1.2.36 (2018-07-18):
654 * aven:
656   + Add support for exporting as a CSV (Comma-Separated Values) file.
658   + Support exporting KML with altitude mode "clamp to ground".  In this mode,
659     the altitude in the data is ignored and it's rendered on the surface of the
660     terrain.  This is useful if your KML viewer renders the terrain as opaque
661     so underground data isn't visible.  Rendering cave passages on the surface
662     isn't great, but is better than not being able to see them at all.  This
663     option may also be helpful if you want to see where to look on the surface
664     for new entrances.
666   + Highlight surveys with a white loop as the mouse is moved over them in
667     the survey tree.  This is akin to how we highlight a station with a
668     white ring, and allows restoring "double-click survey in tree to zoom"
669     which temporarily required a quadruple-click in 1.2.35.
671   + Only show checkboxes in the survey tree for surveys not stations.
673   + Fix wxWidgets assertion if the user tried to select additional surveys
674     to show via the right-click menu.
676   + Fix multiple survey filtering when both a parent and child survey are
677     selected.  In this case it makes most sense to show all child surveys of
678     the parent, but we actually showed a slightly arbitrary subset of the
679     child surveys of the parent.
681   + The checkbox area in the survey tree is now included in the area which
682     is considered by mouse-over updates such as highlighting the station or
683     survey.
685   + Fix display of double quotes in cavern log window (they were being replaced
686     with control character 0x16 due to a typo in the code).
688   + Add shortcuts to buttons in cavern log window.
690   + Eliminate use of gluErrorString() function which eliminates some
691     deprecation warnings when building on macOS.
693   + Reject multiple --survey command line options for now (only the last has
694     been used for a long time, but now we actually support multiple survey
695     filtering this matters more).
697 * survexport:
699   + Report a useful error when trying to convert a .3d file without coordinate
700     system information to GPS.  Reported by Mark Shinwell.
702   + Handle multiple redundant --survey command line options correctly.
704 * dump3d: Report station flag "WALL", which was added in 1.2.7.
706 * Minor translation updates.
708 * Update manual for Microsoft Windows changes.
710 * tests/: Add test coverage for warnings about suspect readings
712 * Fix warning when compiling with clang.
714 Changes in 1.2.35 (2018-07-03):
716 * aven:
718   + Viewing can now be restricted to multiple surveys.  Use the right-button
719     menu on a survey in the survey tree and select "Show" to enable checkboxes
720     for that survey and all its siblings.  Only the selected surveys are shown
721     on screen, printed and exported.
723   + Don't open a survey when its name is double clicked.  This was happening
724     due to code added to "allow double-clicking to work on wxMSW >= 2.8.11".
725     However, reverting that change still seems to allow double-clicking to work
726     on both wxMSW and wxGTK, but fixes the unwanted additional opening of the
727     survey.
729   + Pick initial survey scaling based on whichever of the window width or
730     height gives the smaller scale.  Previously we always used the window
731     width, which can result in parts of the cave being outside the initial
732     view.  Reported by Wookey.
734   + Drop ability to specify a PROJ string in the export dialog.  This was added
735     to allow exporting to formats such as GPX before we added support for
736     specifying the projection in .svx files, and that support is now mature.
738   + DXF export now uses 2 decimal places (was 6) for the bounding box, for
739     consistency with the precision used for coordinates.
741   + Fix handling of surface flag during export.  In formats which discriminate,
742     legs could previously have got assigned the wrong status.
744   + Fix bug which probably prevented aven starting when OpenGL double buffering
745     is unavailable.  This is unlikely to affect any common configurations.
747   + (Microsoft Windows version): Fix loading of 3d files with non-ASCII
748     filenames.  Issue reported by Matic.
750   + (Microsoft Windows version): Fix incorrect display of some toolbar icons.
751     Probably broken since 1.2.17.
753 * survexport: New command-line export program which uses aven's export code.
754   Replaces 3dtopos, cad3d and findentrances, since it can do all that these
755   tools could do, plus much more.
757 * Merge more Spanish i18n updates from Evaristo Quiroga.
759 * Minor updates to various other translations.
761 * img library:
763   + Now supports reading from and writing to an existing FILE*.
765   + Improve API documentation.
767 * (Microsoft Windows version): Fix packaging to include wxWidgets translation
768   files like it was supposed to, which fixes a few missing translations.  This
769   was probably broken by changes in 1.2.8.  Reported by Evaristo Quiroga.
771 * (Microsoft Windows version): Drop two options from explorer bindings.
772   "Convert to DXF" and "Convert for hand plotting" have both been supported via
773   aven for a while, and that's a more useful way to access them as you can
774   control what gets exported.
776 Changes in 1.2.34 (2018-03-24):
778 * aven:
780   + (Microsoft Windows version): Fix error on startup in the pre-built version
781     of 1.2.33.
783   + (Microsoft Windows version): Now using wxWidgets 3.0.4 (was 3.0.2).
785 Changes in 1.2.33 (2018-03-22):
787 * aven:
789   + Reliably disable scale bar in perspective view.  This is supposed to happen
790     (because the scale across the screen varies in perspective view) but
791     actually the scale bar stayed around until an update was forced for another
792     reason.  Spotted thanks to Pedro Silva Pinto.
794   + Make "no date"/"not in loop" colour grey.  The white was a bit bright and
795     made it harder to see the legs that had colours.  The grey now used is
796     within the brightness range of the other colours.  Fixes #94, reported by
797     Erin Lynch.
799   + Fix KML export - exporting both survey legs and station names resulted in a
800     malformed KML file.  This bug was introduced in 1.2.30 when support for
801     exporting passages and walls was added.  Reported by Erin Lynch in #90.
803   + Consistently use 2 decimal places for altitude in KML output.  Some places
804     used 8 decimal places which is appropriate for lat and long, but clearly
805     overkill for an altitude in metres and increases the file size
806     unnecessarily.
808   + Right-align bearing widget in print/export dialog.  The change to allow the
809     value to wrap round from 360 to 0 in 1.2.27 inadvertently made this control
810     left-aligned (due to incorrect wxWidgets documentation of the default style
811     for this control).
813   + (Unix version): Work around wxWidgets bug so that custom cursors work
814     under GTK3.
816   + (Unix version): Update GTK version reporting - report GTK3, and don't
817     bother to report subversions of GTK2 (it seems to be fairly arbitrary
818     which subversions wxWidgets defines constants for).
820   + Update code to work without warnings when using wxWidgets 3.1.0 (the
821     current development version).
823   + Make movie export code compatible with upcoming FFmpeg 3.5 release.
824     It should still work with the older versions that worked before this
825     change.  Reported by James Cowgill in https://bugs.debian.org/888334
827 * cavern:
829   + Warn about 2 digit years.  We can't change the assumption that these are
830     19xx without risking breaking existing datasets, but the further we get
831     into this century, the more likely such an assumption is to catch someone
832     out.  The warning can easily be quashed by explicitly adding the assumed
833     "19".
835 * The Spanish translation is now up to date once more, thanks to updates from
836   Evaristo Quiroga.
838 * Merge French translation updates from Jean-Marc.
840 * Fix transposed German Northing and Easting labels.  Fixes #95, reported by
841   milosch.
843 * Fill in missing translations of "Easting", "Northing", "E" and "N" for
844   Bulgarian, Greek, Hungarian, Polish and Russian based on other existing
845   translated messages.
847 * Align .pos file headings better with columns of coordinates below for
848   Indonesian and Polish.
850 * Fix handling of the message string "error" before messages loaded.  If
851   there's an error loading messages, we need this message to report it.
852   Reported by Martin Sluka.
854 * Fix a few compiler warnings.
856 * img library: Fix extracting leaf survey name for survey title.  When there
857   are three or more levels of survey, we were taking everything after the first
858   dot rather than everything after the last dot.
860 * Fix problems with testsuite on macOS:
862   + cavern.tst: Skip "ONELEG" testcase on case-insensitive filing systems
863     - this test isn't meaningful unless the filing system is case-sensitive,
864     but happens to fail if it isn't.
866   + cavern.tst: Workaround limitations of Apple's sed.
868   + aven.tst: Fix not to hang on macOS.
870   + smoke.tst: Remove aven testcases which duplicate those in aven.tst.
872 * Clean up handling of support files in relocatable installs - this is now
873   detected at run time on macOS.
875 * Split out macOS Aven.app creation into a make rule so it can be easily used
876   by the homebrew formula.
878 * buildmacosx.sh:
880   + Fix when WX_CONFIG not specified - this was giving a confusing error like:
881     ./buildmacosx.sh: line 163: --cc: command not found
883   + Use wxWidgets 3.0.4.
885 * Stop checking wx-config --ldflags as this option was removed in wxWidgets 2.6
886   and we currently require 2.8 or newer.
888 Changes in 1.2.32 (2017-07-08):
890 * aven:
892   + Make splays on printouts a darker shade of grey.  Reported by Erin Lynch
893     and Anthony Day.
895   + In export formats which include 3 dimensions (DXF, PLT, GPX, KML, JSON,
896     POS), the value in the Z dimension was negated.  Bug introduced by fixes
897     for export of rotated plans and tilted elevations in 1.2.27.  Reported by
898     Erin Lynch in #89.
900   + Ignore viewing angles for export formats which work in 3D.  When the
901     rotation and tilt controls are hidden in the export dialog we were still
902     using their values to transform the data, so if you set them with for one
903     export format which support them, then switched to an export format which
904     doesn't, you'd get bogus coordinates in the exported file.  Bug probably
905     introduced in 1.2.27 by fixes for exports of rotated plans and tilted
906     elevations.
908   + Fix exporting to skencil and Survex .pos formats.  When aven's export to
909     .pos was added in 1.2.19, the ordering didn't match up and since then .pos
910     export has produced skencil files and vice versa.
912   + Don't leave terrain on if loading terrain data fails.  Previously if you
913     clicked the terrain icon (or via the menu) with no terrain loaded, but no
914     terrain got loaded (e.g. because the survey data lacks an explicit
915     coordinate system, or because the file failed to load, or because you
916     cancelled the dialog) then the terrain icon/menu item was still changed to
917     "on".
919   + Disable texturing while drawing terrain.  Previously the terrain got a bit
920     darker when "Textured Walls" were enabled.
922   + Force a refresh when "Textured Walls" are enabled or disabled.  Previously
923     the display wouldn't update right away.
925 * Manual:
927   + Document how to specify fixed point altitude in feet.
929   + Explain why *fix warns about unused fixed points
931 * Building from source now requires a compiler with decent support for C++11.
932   If you're using GCC, then GCC 4.7 should suffice.  This should not be an
933   onerous requirement - e.g. Debian wheezy and Ubuntu trusty both have a recent
934   enough GCC.  If special options are needed, these should get probed for and
935   automatically.  Fixes building 1.2.31 with GCC < 6, reported by Wookey.
937 Changes in 1.2.31 (2017-07-01):
939 * aven:
941   + Use superscript 'g' symbol instead of word 'grads' in status bar.  This
942     conserves the limited space available, and we already do this in the
943     compass and clino indicators so it's more consistent too.
945   + Show one decimal place on measure line bearing.  Pointed out by Benedikt
946     Hallinger on the therion list, though I'm sure this has been asked for
947     before by others.
949   + Show gradient of the measuring line when both ends are stations.
951   + Allow selection of text in cavern log window.  Selection was disabled in
952     1.2.28 because it seemed you couldn't actually copy selected text to the
953     clipboard, but retesting this now actually works fine for me, both with
954     current git master with the change reverted, and with code just before the
955     original change.
957   + More robust parsing of cavern output (cleanly handle context highlighting
958     which extends beyond the end of the line).
960   + Allow showing duplicate legs as dashed lines or hiding them entirely,
961     with dashed now being the default.  Implemented by Patrick Warren.
963   + Also allow "Dashed" for splays and "Faded" for duplicate legs.
965   + Splay legs in surface data are also shown faded.
967   + Check environment variables VISUAL and EDITOR when looking for editor to
968     use when a warning or error is clicked on in the cavern log window.  The
969     specified editor may have a GUI or need to run in a terminal, so we have to
970     special-case each editor supported, and that means we can pass extra
971     options needed to position the cursor on the appropriate line/column.
972     Currently these editors are supported: gvim, nvim, vim, gedit, pluma,
973     emacs, nano, jed, kate.  Suggested by Wookey.
975   + Fix handling of non-square terrain data files - the X and Y dimensions were
976     swapped.  Reported by detrito.
978   + Improve parsing of DEM data with .hdr file.  Use documented defaults for
979     more values, and where we only support a subset of values (or a particular
980     value) check for unsupported values in more cases.
982   + When colouring by depth, fix colouring and texturing of polygons which
983     cross depth bands.  The previous problems were most obvious with high
984     chambers and long legs down deep pitches, especially in for surveys without
985     much vertical range.
987   + Support for drawing blobs using point sprites was added in 1.2.28,
988     but caching that this worked wasn't hooked up properly so the test to
989     see if this worked would happen at the start of each run.  This is now
990     cached as intended which should reduce start up time a little when blobs
991     are drawn in this way.
993   + Fix drawing of crosses with lines.  This is a fall-back case which is
994     rarely used as most OpenGL setups will handle a better method, but it was
995     resulting in crosses with a four-pixel square in the centre - now the
996     centre should be a single pixel.
998 * cavern:
1000   + Allow *data with no arguments to reset the current style - useful for
1001     entering passage data where there are side passages.
1003   + Fix hang processing file without newline at end.  This bug was introduced
1004     by changes in 1.2.28.  Reported by Mark Brown.
1006   + (Mac OS X and Microsoft Windows versions): Build with newer version of
1007     PROJ library which fixes buggy handling of *fix with lat-long coordinates.
1008     Also add a testcase to the testsuite to alert users building for themselves
1009     with an affected PROJ version on any platform.  Reported by Ross Davidson.
1011   + Fix cavern to handle Compass .DAT with no survey team.  Previously this
1012     resulted in the bogus error: Expecting numeric field, found "FROM"
1013     Reported by Erin Lynch.
1015   + Handle UTF-8 "BOM" at start of .svx files.  Unicode doesn't recommend its
1016     use, but Microsoft stuff seems to like to create files with it in, and the
1017     error cavern currently reports for such files is very confusing, so it
1018     seems best to just handle it.  Reported by Rob Eavis.
1020   + Change a couple of messages to use double quotes for consistency with all
1021     other messages.
1023 * extend:
1025   + Now runs a bit faster.
1027   + Splays are now carried over the extended survey.  The current handling
1028     is simplistic, but should do a good enough job to be more useful than
1029     discarding splays.  The splays at each station are all rotated together
1030     based on the bearing between the stations either side of the current one
1031     along the first path extended through that station.  This nicely handles
1032     dead ends and the situation at the top or bottom of a pitch, and should
1033     tend to pick an angle close to the passage orientation along a traverse.
1034     It's weakest at junctions.  Feedback (especially examples which could
1035     be handled better) most welcome.
1037 * French translation is now up to date again, thanks to Jean-Marc.
1039 * Remove erroneous menu shortcut markers from Polish translations.
1041 * Fill in some missing translations in several languages by using message
1042   translations from therion.
1044 * Add note to *fix documentation to clarify the coordinate order with *cs
1045   long-lat.  Issue raised by Ross Davidson.
1047 * Fix errors in documentation of *units: "DEG" should be "DEGS", and
1048   "MINUTES" has been supported for ages but wasn't documented.  Reported by
1049   Footleg.
1051 * Fix a few typos in the documentation.
1053 * Fix compilation warning with recent GCC.
1055 Changes in 1.2.30 (2016-10-03):
1057 * aven:
1059   + (Microsoft Windows version): Fix crash when trying to print or export
1060     (probably introduced in 1.2.28).  Reported by Brian Clipstone.
1062   + Report error if terrain file contains no terrain data in area of survey.
1063     Suggested by detrito.
1065   + Errors when writing an export file were reported with the wrong filename
1066     - the .3d file, not the filename we were trying to write to.
1068   + Export to KML now supports exporting passages, walls and cross-sections.
1069     Addresses the remainder of ticket #4.
1071 * Add man page for dump3d.
1073 Changes in 1.2.29 (2016-09-27):
1075 * aven:
1077   + Fix SVG output with non-ASCII characters (the charset in the SVG file
1078     is now set to UTF-8 not ISO-8859-1).
1080   + (Microsoft Windows version): Fix error dialog on startup in pre-built
1081     version.  Reported by Brian Clipstone.
1083 * Manual: Add link to TerrainData wiki page.  Omission highlighted by Erin
1084   Lynch and "detrito".
1086 * Fix to build without FFmpeg/libav and with older versions, broken by changes
1087   in 1.2.28.  Reported by James Begley.
1089 Changes in 1.2.28 (2016-09-24):
1091 * cavern:
1093   + Show the contents of the line after error and warning messages while
1094     processing survey data, and indicate the region of the line in many cases
1095     in the same style that compilers such as GCC and clang use (using the
1096     column number we already have, plus new width information).  Based on a
1097     patch from Mateusz Golicz.
1099   + Add column and width information for many more error and warning messages.
1101   + Fix column for "Separator in survey name" warning.
1103   + Improve warnings when using a backclino with range 0-180 degrees (reusing
1104     the same machinery we already have for a forward clino with range 0-180
1105     degrees).
1107 * aven:
1109   + Include LRUD in printout/export of extended elevations, broken by
1110     improvements to export of tilted elevations in 1.2.27.  Reported by Anthony
1111     Day.
1113   + Name <trk> tags in GPX output, so Garmin GPS units name the imported track
1114     usefully.  Reported by Anthony Day.
1116   + Remember scale from previous print or export operation in the same run of
1117     aven.  Suggested by Stuart Bennett.
1119   + Convert range indication below shown line to a highlight on that region
1120     of the line in cavern log window.
1122   + Fix colouring of error/warning without column in cavern log window.
1124   + Fix click on error/warning without column in cavern log window.
1126   + Fix highlight of translations of "error" or "warning" containing non-ASCII
1127     characters.  This fix for this only works with a Unicode build of
1128     wxWidgets, but as of wxWidgets 3.0, all builds are Unicode, so this
1129     shouldn't be much of a problem as wxWidgets 2.x is close to obsolete now.
1130     Reported by Mateusz Golicz.
1132   + Disable selection of text in cavern log window - you can't currently copy
1133     it to the clipboard, so until that's implemented it seems better to disable
1134     the ability to select it.  Reported by Wookey.
1136   + Avoid special "1000" scale entry when exporting.
1138   + Show 1 page when "One Page" selected.
1140   + Reload processed data when restricting view.  Fixes failure when
1141     restricting view on data just processed via aven.  Spotted by Andrew
1142     Atkinson and myself.
1144   + Don't hide blobs and crosses behind terrain.  Reported by Jenny Black.
1146   + Fix rendering of crosses using point sprites.  The texture being used was
1147     misaligned relative to the image used for the visual fidelity check, so the
1148     check always failed and point sprites would never be used.  Where point
1149     sprites are supported, they're probably the fastest option - on my netbook
1150     this change improves FPS by ~6 fold when displaying crosses for a large
1151     survey.
1153   + Support drawing blobs using point sprites.  About 5 times faster than using
1154     lines on my netbook.
1156   + Recheck how best to draw crosses and blobs on the first run after Survex
1157     is upgraded (or downgraded) as the rendering code may have changed (we
1158     already recheck when the OpenGL hardware or driver changes).
1160   + Change "MPEG" export to be MPEG4 (.mp4) rather than MPEG1 (.mpg).
1161     MPEG4 produces smaller output of higher quality, and should be widely
1162     supported these days.  And I can't get the MPEG1 output to work without
1163     buffer underflows, resulting in a file which doesn't play without
1164     glitches.
1166   + Add OGG video to the list of formats - it's more compact than the others
1167     we currently list, though slower to write.
1169   + Fix export to movie formats for which libav/FFmpeg needs to seek the file
1170     being written.  This was broken by changes in 1.2.27.
1172   + Overhaul movie export for the current FFmpeg API, fixing deprecation
1173     warnings when building against a recent version.
1175   + (Microsoft Windows version): Fix corrupted exported movie files.  1.2.27
1176     changed the movie export code to allow writing to files with non-ASCII
1177     characters in the names, but the new code failed to open the file in binary
1178     mode, leading to corrupt output.  Fixes #81, reported by Erin Lynch.
1180   * (Microsoft Windows version): Pre-built version now uses FFmpeg 3.1.3 for
1181     movie export.
1183   * (Mac OS X version): Pre-built version now uses FFmpeg 3.1.3 for movie
1184     export.
1186 * Fix to build without FFmpeg/libav, broken by changes in 1.2.27.  Reported by
1187   James Begley.
1189 * The Polish translation is now very close to being complete, thanks to a
1190   substantial update from Mateusz Golicz.
1192 * Merge catalan translation updates from Adolfo Jayme.
1194 * (Microsoft Windows version): Map LANG_CHINESE to zh_CN not zh so Chinese
1195   messages get used automatically.
1197 * cavern.tst: Remove random : from after ] - dash ignores the extra character,
1198   but it causes this test to fail if /bin/sh is a different shell (e.g. bash).
1200 * cavern.tst: Add expected output for more testcases.
1202 * Remove unwanted execute bit from some testcase data.
1204 * Use https for more URLs which support it.
1206 Changes in 1.2.27 (2016-06-06):
1208 * aven:
1210   + Right click on a survey in the survey tree now gives a pop-up menu
1211     with "Hide others", which restricts the view to just that survey
1212     and any subsurveys.  Right click on the root of the survey tree
1213     gives a menu with "Show all" to undo any restriction in effect.
1214     (Currently these are implemented by reloading the file and using
1215     the same machinery as the --survey= command line option, but that will
1216     probably change in the future).
1218   + If there's a sub-survey restriction (from the --survey= command line
1219     option or the new UI described above) it is now shown in brackets after
1220     the survey tree root.
1222   + When reloading a survey, preserve the current view position (previously
1223     the view was recentred).
1225   + When reloading a survey, actually preserve the current scale factor
1226     (this was meant to happen, but the adjustment was applied in the
1227     wrong direction).
1229   + New "File->Extended Elevation..." menu item provides a way to generate
1230     extended elevations for simple cases without having to use the command
1231     line.  Suggested by Fleur Loveridge.
1233   + Don't process key presses if accompanied by an unexpected modifier key.
1234     In particular, this means that aven no longer interferes with Alt+<function
1235     key> (which is typically handled by the desktop) and Alt+<letter> (which is
1236     typically a menu short cut).  Reported by Владимир Георгиев.
1238   + Reduce file loading time by ~5%.  The station name compare function was
1239     something of a hot spot, and optimising it yielded a nice improvement.
1241   + Allow splay legs to be disabled in when printing and exporting.  Mostly
1242     addresses #60.
1244   + SVG export now shows splay legs thinner and in grey.  See #60.
1246   + Fix export of rotated plans and tilted elevations - previously plans were
1247     always aligned with North up, and elevations which weren't exactly side on
1248     were exported as plans.  Reported by Stuart Bennett.
1250   + Fix offset bounding box for exported elevations.
1252   + In print/export dialog the bearing value now wraps if you scroll up past
1253     360 or down past 0.
1255   + Fix greying out of LRUD-based controls in the print/export dialog when the
1256     view is tilted (i.e. not plan or elevation).  This stopped working in
1257     1.2.18 when the pan and tilt spin controls were changed from integer- to
1258     real-valued ones.
1260   + Printouts now show LRUD as pale grey arrows from the station they are
1261     measured from.  Based on patch from Michael Sargent.  Closes #65.
1263   + Take LRUD into account for printout size.  Fixes #72, reported by Erin
1264     Lynch.
1266   + Update movie export code to work with latest version of FFmpeg.
1268   + Make "Show Log" a toggle, so you can click on the button to take a look at
1269     the log, and a second click returns you to the survey view.
1271   + (Microsoft Windows version): Open the font file in binary mode - it looks
1272     like we were lucky and the font file (or at least its current version)
1273     would have loaded OK in text mode despite being binary data.
1275   + (Microsoft Windows version): Exporting to files with non-ASCII filenames
1276     should now work.
1278 * cavern:
1280   + Allow tape or backtape to be omitted.  Reported by Erin Lynch.
1282   + Grid convergence is now corrected for when using automatically
1283     calculated declinations (*declination auto <X> <Y> <Z>).  Requested
1284     by Mateusz Golicz on the mailing list.
1286   + Clear any cached calculated declination upon another *declination auto
1287     with different coordinates.  Previously if the date stayed the same,
1288     a previously cached declination for the old coordinates was used.
1290   + Fix check for end of version number array in *require.  We would check up
1291     to 12 version components, the last 9 being bogus.  In practice, *require is
1292     only likely to be used with up to three components, so this wouldn't be an
1293     issue.
1295   + *begin with an invalid prefix could cause a crash in some cases.  Fixed
1296     by patch from Colin Watson.
1298   + Report column locations for errors to do with readings.
1300 * Merge translation updates from Jean-Marc.
1302 * img library: Better document which members can be set when writing.
1303   Highlighted by email query about use of img API from Владимир Георгиев.
1305 * Document how *declination interacts with *calibrate declination if both are
1306   used in the same dataset.
1308 * doc/3dformat.htm: Update details of how changes to the current label buffer
1309   are encoded to reflect changes in v8.  Reported by Angus Sawyer.
1311 * Use docbook2man instead of docbook-to-man to generated Unix man pages
1312   from SGML source.  The latter seems to be no longer actively maintained, and
1313   docbook2man now does a similarly good job.
1315 * Use https for survex.com links, and for other sites which support it.
1317 Changes in 1.2.26 (2016-01-07):
1319 * aven:
1321   + (Microsoft Windows version): Fix to be able to process .svx files with
1322     cavern again.
1324 * (Microsoft Windows version): Simplify upgrading process with innosetup
1325   installer - if Survex is already installed, we now just install to the same
1326   location and use the same start menu folder.
1328 * (Linux version): survex.spec: Update for filetype metadata change in 1.2.25.
1329   Fixes #79, reported by James Begley.
1331 * (Linux version): survex.spec: Fix to work with RPM 4.13.  Fixes #79, reported
1332   by James Begley.
1334 Changes in 1.2.25 (2016-01-05):
1336 * aven:
1338   + Drop broken code which attempts to fix 2D pitches.  Fixes #73, reported by
1339     Erin Lynch.  #76 tracks the issue the removed code was trying (but failing)
1340     to address.
1342   + When animating, don't try to update station info based on mouse movement
1343     over the survey tree.
1345   + Further improve code to handle cavern subprocess in aven.
1347   + Fix jump to error for filenames containing colons when the error location
1348     doesn't have a column number.  Bug noted by Jenny Black.
1350   + If we encounter bad UTF-8 in cavern output, replace it with a red and white
1351     ? in a diamond (previously we gave up showing output at the first bad
1352     sequence).  This can happen if you process a .svx file which isn't UTF-8
1353     encoded.
1355   + (Unix version): Don't try to set the terminal window title when opening an
1356     editor from the cavern log window - gnome-terminal no longer supports this,
1357     and there doesn't seem to be a portable option for specifying the title for
1358     terminals which do still support this.
1360   + (Microsoft Windows version): Also quote for cmd.exe so that paths with
1361     spaces in work reliably.  Reported by Marco Cotto.
1363 * cavern:
1365   + Improve error for mismatched fore/back-sight plumbs, reported by Andy
1366     Edwards (see #78).
1368   + Fix to use correct sd for backcompass.  We were using zero instead, the
1369     most obvious effect of which was that the threshold for warning about
1370     differing COMPASS and BACKCOMPASS was about 71% of what it should have
1371     been, so we were warning in more cases than we should have been.
1373   + Implement support for specifying a length on backsights - if you're using
1374     something like a disto-x, you'll get a distance reading for the backsight
1375     too.  Fixes #71, reported by Erin Lynch.
1377   + Make line counting more robust to mixed line ends.  Noticed in example file
1378     from Pete Smart (see #69).
1380 * extend: New --show-breaks option which adds a leg flagged as surface survey
1381   between each points at which a loop has been broken.  Suggested by Jenny
1382   Black.
1384 * (Unix version): Update filetype metadata to work with modern desktops.
1386 * Fix incorrect reporting of errors reading and writing processed survey data.
1387   Since 1.2.8, the error strings corresponding to IMG_CANTOPENOUT,
1388   IMG_BADFORMAT and IMG_DIRECTORY have been mixed up (this doesn't affect
1389   external programs using the img library, only Survex).  Reported by Jenny
1390   Black.
1392 * Add missing options to extend man page and --help output.  Noted by Jenny
1393   Black.
1395 * Document Document Ctrl+cursor keys for rotating and tilting in aven man page.
1397 * Fix broken SGML markup in manual.
1399 * Fix typo in manual reported by Jenny Black.
1401 * Update vim syntax file for newer commands, etc.
1403 * Minor translation updates.  Thanks to Piotr Strębski and Jean-Marc.
1405 * Fix to compile with FFmpeg 2.9.  Reported by Andreas Cadhalpun in
1406   https://bugs.debian.org/803863
1408 * Stop maintaining ChangeLog files.  They make merging patches harder, and stop
1409   'git cherry-pick' from working as it should.  The git repo history should be
1410   sufficient for complying with GPLv2 2(a).
1412 * (Microsoft Windows version): The installer requires admin privileges on Vista
1413   and later and OS versions older than Vista are past end of life, so drop code
1414   which tries to set up the registry differently depending if we have admin
1415   privileges or not.
1417 Changes in 1.2.24 (2015-09-23):
1419 * aven:
1421   + (Microsoft Windows version): Fix the cavern log window.  Reported by Brian
1422     Clipstone.
1424   + (Microsoft Windows version): Add workaround to avoid breakage in Therion.
1425     Reported by Jenny Black.
1427   + If wx was built with thread support, aven now runs cavern from a separate
1428     thread, which works much better under wxMSW (where we can't use select),
1429     and also seems a bit smoother on Linux.
1431   + Fix handling of encoding of filenames when the operating system has no
1432     locale installed corresponding to the language selected for Survex's
1433     messages.
1435   + Undo accidentally committed debugging code which was sending message to
1436     the terminal in 1.2.23.
1438 * (Linux version): configure now looks first for wx-config-3.0, which Fedora's
1439   wx3 packages have.  Reported by James Begley.
1441 * Indonesian translation fully up to date again.
1443 * Manual: Document anonymous stations, based on the text from NEWS.  Reported
1444   by Wookey.
1446 Changes in 1.2.23 (2015-09-06):
1448 * aven:
1450   + Updating the cavern log window is now much smoother, especially on slower
1451     machines.
1453   + Show "busy" mouse cursor while processing survey data.
1455   + Fix an assertion if you try to start processing a survex file while one is
1456     already being processed.
1458   + Processing a .svx file with an error now still adds it to the file history.
1459     Reported by Martin Green.
1461   + Fix the orientation of the starting end of tubes.
1463 * cavern:
1465   + New *ref command to allow specifying an external reference (e.g. where to
1466     find the original survey notes).
1468   + Drop support for showing percentage progress in cavern.  It's confusing in
1469     a multiple-file dataset as it shows progress in the current file so jumps
1470     around.  It also slows down processing, and on a slow machine you'd don't
1471     want that, while on a fast machine processing isn't slow enough for the
1472     progress display to be useful.
1474 * French translation is now completely up to date, thanks to Michel Bovey.
1476 * Bundle proj's EPSG and ESRI code lists in the installers for MS Windows and
1477   OS X so that things like "*cs EPSG:29903" work.  Reported by Graham Mullan.
1479 * (Microsoft Windows version): Process survey data with aven rather than
1480   running cavern.
1482 * (Microsoft Windows version): Installer built with InnoSetup 5.5.6 (recent
1483   releases have been built with 5.5.3) to see if that solves Ray Duffy's
1484   reported issue with not having file associations for .svx files created.
1486 Changes in 1.2.22 (2015-08-17):
1488 * aven:
1490   + Ensure that the window has a depth buffer.  Whether it does by default
1491     seems to vary depending on OS and maybe graphics card.  Fixes #55 (terrain
1492     is no longer visible through itself), and also the rendering of passage
1493     tubes.  Thanks to Martin Green for pointing me in the right direction for
1494     finding this fix.
1496 * cavern:
1498   + Fix *declination with an angle to actually work.
1500   + Fix assertion if we try to identify a hanging survey by an anonymous
1501     station.
1503   + Improve errors for invalid survey names in *begin, *end, *equate and
1504     *export.
1506 Changes in 1.2.21 (2015-07-28):
1508 * aven:
1510   + Fix exporting to KML and other text-based formats to always use "." for the
1511     decimal separator - previously "," would be used when the user's locale
1512     specified this for the decimal separator.  Reported by Jan Schorn.
1514   + Implement exporting of survey legs in KML format.
1516   + Put "paddle" placemarker icons on stations in exported KML files, using the
1517     same colour coding for entrances, fixed points and exported points as aven
1518     does.
1520   + Remove the "Coordinate projection" field from the print dialog, as it isn't
1521     relevant there.  Reported by Wookey.
1523   + Fix the initial scale for small caves (since 1.2.18 the initial scale has
1524     been too small).  Reported by Wookey.
1526   + Don't rescale if the same file is reloaded, but adjust the volume diameter
1527     as appropriate.
1529   + Use wxGetenv() to read the SURVEXEDITOR variable, so we can accept Unicode
1530     values on Windows.
1532 * cavern:
1534   + Fix coordinate systems using latitude and longitude - PROJ.4 wants these in
1535     radians, but we were passing degrees, which would generally cause the
1536     conversion to the output coordinate system to fail.  Reported by Wookey.
1538   + Fix *fix with standard deviations when *cs is in use, give an error for use
1539     of *fix with standard deviations before *cs.
1541   + Add new *declination command with support for setting the declination
1542     automatically from the IGRF model based on the survey date.  Thanks to the
1543     Therion developers for the IGRF support code, which we're reusing.
1544     Fixes #54, reported by Wookey.
1546   + Allow the units for the zero error to be specified, making it easier to
1547     specify calibration with a scale if you measure the zero error externally
1548     (rather than using the instrument itself).  Fixes #61, reported by Andrew
1549     Atkinson.
1551   + Report the error from PROJ when coordinate conversion fails as part of the
1552     actual error rather than on a separate line.
1554   + Fix use after free after *solve.  This only occurs if a leg between the two
1555     exact same stations appears right before and right after the *solve, which
1556     is unlikely in real data, but the testsuite has an instance of this.  This
1557     was introduced by the repeat leg averaging added in 1.2.17.
1559   + Fix small memory leak when solving network.  This doesn't really matter
1560     when solving at the end of processing as cavern will exit after that, but
1561     if *solve is used we continue processing after solving.
1563 * Remove compatibility handling for specifying a country variant of a language
1564   in SURVEXLANG using "-" with a lower case country code (e.g. "en-us") - we
1565   changed to the standard "en_US" way back in 2001.  This code was mangling
1566   character sets with a "-" in, and is no longer useful.
1568 * Ignore any "@<something>" modifier in the language code.
1570 * Improve documentation of magnetic declination handling, and cover the new
1571   "*DECLINATION" command.
1573 * Document aven's command line options in the manual and its man page.
1574   Reported by Jenny Black.
1576 * Point to '*case' and '*truncate' from the 'SEE ALSO' sections of each other's
1577   documentation.
1579 * Remove references to SpeleoGen from the documentation - it hasn't been
1580   updated for many years, and can't read recent versions of the .3d format.
1582 * Strip documentation references to obsolete versions of MS Windows.
1584 * doc/HACKING.htm: Update list of debian packages to install to build from git.
1586 Changes in 1.2.20 (2015-06-26):
1588 * aven:
1590   + When printing, use the top margin rather than the right margin to calculate
1591     the height of the printable area.  In practice, the two values seem to be
1592     the same or very similar by default.
1594   + Avoid assertion if the about dialog image fails to load.  Reported by Phil
1595     Maynard.
1597   + Optimise the size of the about dialog images.
1599   + Add support for reading terrain data which isn't in a .zip file.
1601   + Force a refresh after loading terrain data so that it gets displayed right
1602     away.
1604   + Make checks for terrain data extensions in zip files case insensitive.
1606   + If reading terrain data fails, always report an error and never try to
1607     display it.
1609 * cavern: Allow clino readings in diving style data, suggested by Andrew
1610   Atkinson.  Currently these readings are ignored, but a future version will
1611   check that they're consistent with the angle given by the depth gauge and
1612   tape, and perform suitable averaging.
1614 * Remove lingering traces of svxedit.
1616 * configure: Fix to allow compiling without libav/ffmpeg, as was possible
1617   before 1.2.19.
1619 * (Unix version): Install the filetype and aven application icons under
1620   /usr/share/icons/hicolor, which is where they're expected to be these days.
1622 * (Unix version): Add %f to Exec in survex-aven.desktop.
1624 * (Mac OS X version): Remove useless extra copy of about box images from OS X
1625   disk image.
1627 * (Mac OS X version): Only ship one copy of each of the translations.
1629 * (Mac OS X version): Reduce the size of the aven binary by disabling a load of
1630   libav features we don't use.
1632 * (Microsoft Windows version): Reduce the size of the aven binary by disabling
1633   a load of libav features we don't use.
1635 * (Microsoft Windows version): Update message files to fix a missing Chinese
1636   message in the installer.
1638 Changes in 1.2.19 (2015-06-18):
1640 * aven:
1642   + Fix exporting to GPX, KML and HPGL, which all failed to write the header to
1643     the exported file in 1.2.18.
1645   + Add exporting to Survex .pos format.
1647   + If the measuring line isn't currently active, pressing "Escape" will now
1648     exit full screen mode.
1650   + (Mac OS X version): Change the shortcut for full screen mode to be the
1651     standard Ctrl+Command+F (rather than Shift+Command+F which we have been
1652     using since 1.2.7).
1654   + (Mac OS X version): When we centre the view on the station this can
1655     generate a mouse move event, so clear the variable which says we are
1656     dragging before we process a left click on a station.  This avoids random
1657     rotations of the survey when clicking on a station, reported in #47 by Hugh
1658     St. Lawrence.
1660   + (Mac OS X version): Force use of a non-native toolbar to stop the toolbar
1661     icons from being rescaled and looking fuzzy.
1663   + (Mac OS X version): Remove code added in 1.2.18 which tries to set stop the
1664     toolbar icons from being rescaled, but which requires an unreleased version
1665     of wxWidgets, had a typo in, and doesn't actually seem to work anyway.
1667   + (Mac OS X version): Drop out of full screen mode if the mouse is mode to
1668     the top of the screen, since we can't seem to display the menu bar in this
1669     case like we do on other platforms.
1671   + (Mac OS X version): Enable aven's movie export feature.
1673   + (Mac OS X version): Enable wxDisplay when building wxWidgets to better
1674     support multi-monitor setups.
1676   + (Mac OS X version): Silence warning visible when aven is run from a
1677     terminal about a missing CFBundleTypeRole.
1679   + When reading terrain data from a .zip file, report an error if the .zip
1680     file is bad, or if it doesn't contain any terrain data we recognise.
1682   + Tweak error message in terrain reading code to distinguish two failure
1683     cases.
1685   + Add viewing angles and scale to footer, and shorten some of the other items
1686     to make room for this extra information.  (Fixes ticket #52, reported by
1687     Erin Lynch)
1689   + If the footer is wider than the printout width, scale down the font used
1690     so that it exactly fits; if the footer is narrower, than space out the
1691     items in in so it uses the full width.
1693   + If the saved size for aven's window exceeds the current display size
1694     (mostly likely because we're now plugged into a smaller monitor), then
1695     reduce the size of the window to fit the display.  If the saved size is <
1696     (480x320), increase it to at least that, as aven isn't usable in a smaller
1697     window.
1699   + Remove crude bodge which tries to pick a nicer initial window size when
1700     using wxWidgets without wxDisplay on a multi-monitor setup - aven now opens
1701     with the same size window it had when it was closed, so the initial size is
1702     only relevant on the first ever run.
1704 * Assorted translation updates.  Notably Indonesian is at 100% again.
1706 * Stop trying to catch and report signals.  The only real reason to do it is so
1707   we can say "Bug in program detected! Please report this to the authors"
1708   before we exit, but when the program crashes that's pretty obvious.  In aven
1709   we try to pop up a message box for this message, which may fail due to
1710   whatever caused the signal, while with the command line tools there's no
1711   great benefit over just letting the shell report the signal.
1713 * Use pkg-config to probe for libav and proj, which sorts out the correct flags
1714   for building on OS X against a static install of libav.
1716 Changes in 1.2.18 (2015-06-03):
1718 * aven:
1720   + Add support for reading terrain data (from a zip file containing either an
1721     SRTM .hgt file, or an ESRI .bil file and associated metadata files), and
1722     rendering it as a transparent surface.
1724   + Remove actions from 'Orientation' and 'Rotation' menus which you wouldn't
1725     sanely want to perform from the menu.
1727   + Create a "Colour by" submenu of the "View" menu to house the various
1728     colouring options.
1730   + Add "Colour by Gradient" and "Colour by Length".
1732   + Make the button to dismiss the "About" dialog "OK" rather than "Close",
1733     which seems more logical, and also allows the dialog to be closed by
1734     pressing "Escape".
1736   + Destroy any existing clipping region before we write the page footer.
1737     Hopefully solves ticket #52, reported by Erin Lynch.
1739   + Don't round bearing and tilt angles to integers when printing and
1740     exporting.
1742   + Add passage export for EPS format.  (Partly addresses ticket #4)
1744   + Add JSON export.  This should be regarded as experimental, and the format
1745     is quite likely to change.
1747   + Pressing F6 now toggles the display of rendering stats, currently FPS
1748     (Frames Per Second) and the number of triangles in the terrain mesh.
1750   + Add a menu item and toolbar button to show the cavern log window if the
1751     currently shown survey data was processed by aven.  Reported by Hugh St
1752     Lawrence in #47, and by Dave Clucas and others previously on the list.
1754   + Add "Save Log" button to Aven's cavern log window.
1756   + In cavern log window, highlight "error" markers in red and "warning"
1757     markers in orange.
1759   + Rework code to read cavern's output.  In particular, we no longer mix
1760     buffered and non-buffered system calls.
1762   + Aven's support for reading colours and font sizes for printouts from
1763     print.ini has never worked - the contents of the ini files are ignored due
1764     to a bug which has been there since the code was added in 2005 - but nobody
1765     has ever complained.  So just strip out that code entirely - we should
1766     support setting the colours and font sizes, but a GUI interface for setting
1767     them would be better.
1769   + Fix to compile with a Unicode build of wxWidgets 2.8.  Reported by Bill
1770     Gee.
1772   + Take the width of the messages used above the compass and clino into
1773     account when calculating how much space to allow for them - now the labels
1774     won't overlap or be cut off in translations where they are long.
1776   + (Mac OS X version): Attempt to address the size of the toolbar icons.
1778 * cavern:
1780   + Reject *fix with SDs which aren't all positive.  (fixes#2, reported by
1781     susscorfa).
1783   + Use the currently set units when outputting measurements in warnings,
1784     errors, and the stats at the end of the run.  Requested by Bill Gee.
1786   + Include column number when a *include file isn't found.
1788   + Show 'error' in front of error messages, like we show 'warning' in front of
1789     warnings.  Fixes #48, reported by Wookey.
1791   + Increase the threshold for warning that fore and back measurements differ
1792     from 2 SDs to 3 SDs.
1794 * findentrances: If the 3d file specifies the coordinate system, use it.
1796 * svxedit: Remove svxedit - while an editor with built-in knowledge of survex
1797   would be nice to have, svxedit doesn't really offer that, and it looks ugly
1798   in a modern desktop.
1800 * If we run out of memory while reading a processed survey data file, include
1801   the filename in the error message.
1803 * Many translation updates - notably Indonesian and Russian are now the two
1804   most complete translations.
1806 * (Microsoft Windows version): Add code page 1252 mappings for fancy quotes.
1808 * Transliterate gradient and infinity symbols if the current character set
1809   lacks them.
1811 * Add SVG version of .plt icon.
1813 * Manual:
1815   + Add complete list of quantities you can set SDs for.  Thanks for Wookey for
1816     highlighting that the previous list was incomplete.
1818   + Document averaging of a group of repeated readings.
1820   + Add a link to the sample data from the manual.
1822   + Remove references to contact addresses which are no longer there.  Remove
1823     offer to post people floppies, and references to a CD image which isn't
1824     available for download.
1826 * Remove non-breaking spaces from the diffpos and extend manual pages, as they
1827   actually make the output formatting worse (presumably these used to work
1828   around a since-fixed bug in one of the docbook processing tools).
1830 * doc/TODO.htm: Update.
1832 * Fix to compile without warnings with 'g++ --std=gnu++11'.
1834 Changes in 1.2.17 (2015-02-24):
1836 * MacOS X version:
1838   + Update INSTALL file with current status.
1840   + Aven.app now has a custom icon.
1842   + Add icons for all the filetypes supported.
1844   + Add Finder actions for .svx, .3d, .plt and .pos files.
1846   + aven: Hide the status bar and tool bar in Full Screen mode, as wx doesn't
1847     currently do this for us.
1849   + aven: Fix short-cut for toggling Full Screen mode.
1851   + aven: Make "About" menu item appear.
1853   + aven: Fix "Close" button in about dialog.
1855   + aven: Make custom cursors black with a white outline to match the standard
1856     OS X cursor.
1858   + svxedit: Now wrapped up in an application bundle as svxedit.app.  It
1859     still doesn't really work like a standard app though - e.g. you can't load
1860     files from Finder (instead run svxedit.app and use File->Open), the font
1861     size of most menu items is wrong, the icon for the app is the wish icon
1862     rather than the svxedit icon, shortcuts use Ctrl not the Cmd key, and
1863     probably more.  I'd probably recommend using another editor (OS X comes
1864     with TextEdit.app for example).
1866   + The documentation is now in a "Docs" directory alongside the apps, rather
1867     than in the rather less obvious "share/doc/survex" directory.
1869   + Default to building for x86_64, since all modern Macs are 64 bit.
1871   + Disable use of liblzma when building wxWidgets for OS X, which was
1872     preventing the build from working on OS X 10.6.8.
1874   + Download wx sources from SF via redirecting link.  Thanks to David A.
1875     Riggs.
1877   + buildmacosx.sh: Handle the mount point for the disk image containing a
1878     space.
1880   + Link with a static build of PROJ for doing coordinate system conversions.
1882   + Build wx with --disable-webview to avoid a compilation failure on OS X
1883     10.10.1.
1885   + Use wx-config --cc and --cxx to get the compilers to use for building
1886     everything else, as wx adds options to them which otherwise cause linking
1887     errors.
1889   + The diskimage (.dmg) file is now compressed with bzip2, which gives a
1890     smaller download.  This means OS X 10.4 is required, but we probably
1891     already need at least 10.5 because that's the minimum version which the
1892     wxWidgets build supports by default.
1894   + Remove unused files and copies of files from the diskimage.
1896 * cavern: If the same leg is repeated consecutively, average the readings and
1897   treat as a single leg.
1899 * dump3d: Report SEPARATOR used by the file being read.
1901 * aven.svg: Fix visual glitch in SVG icon for aven.  Noted by David A. Riggs.
1903 * aven:
1905   + Greatly reduce flicker when mouse is moved to the top of the screen in full
1906     screen mode and the menu bar reappears.
1908   + For export formats where scaling is supporting, aven now actually uses the
1909     scale specified in the export dialog (previously it ignored this and used
1910     1:500).
1912   + Reimplement animation so that it's based on angular change per unit of
1913     elapsed time, rather than averaging the time take for the last two scene
1914     redraws.  This gives smoother animation in the face of variable load and
1915     scene redraw time, and should be more consistent between platforms.
1917   + Switching to a point of the compass during auto-rotation now jumps straight
1918     there rather than the two animations fighting.
1920   + Reduce the maximum auto-rotation speed, as the previous limit was uselessly
1921     fast.
1923   + Disable stepping the rotation angle when animating (previously we only did
1924     when rotating).
1926   + Speed up start-up a bit - rather than loading icons from individual PNG
1927     files on disk, compile them into the aven binary.
1929 * (Unix version): Add "MimeType" field to desktop files so that file
1930   associations work out of the box with modern desktop environments.
1932 * Add start of Hungarian translation from Imre Balogh.
1934 * Merge in many updates to the Russian translation from "vsuhachev".
1936 * Assorted minor updates to other translations.
1938 * Create scalable (SVG) versions of file type icons.
1940 * doc/manual.sgml: Remove $Id and $Date markers, as they don't get expanded now
1941   we're using git.
1943 * tests/: Improve test coverage in a few places:
1945   + Extend tests of fore and back sights to test calibration of the back
1946     compass.
1948   + Test "Can't calibrate angular and length quantities together" error.
1950   + Check that "*set names ." works when "." is also the decimal point.
1952 Changes in 1.2.16 (2014-10-17):
1954 * aven: Add KML export (stations only currently).
1956 * aven: Allow measuring line to measure from anonymous stations.  (Fixes #44)
1958 * aven: Fix corrupted names in exported files.
1960 * aven: Fix error log window under wxWidgets >= 2.9 to include the system
1961   information before the first log message like it does under wxWidgets 2.8.
1963 * cavern: Add support for "*cs JTSK" and "*cs JTSK03".
1965 * tests/: Improve test coverage.
1967 * Translation updates for many languages, plus the start of translations to
1968   Greek and Polish.
1970 * Fix to build against wxWidgets 3.0 built with assertions disabled.  Reported
1971   by Martin Sluka.
1973 * Fix warnings when compiling with clang (which is the default compiler on
1974   Mac OS X).  Reported by Martin Sluka.
1976 Changes in 1.2.15 (2014-08-14):
1978 * cavern: The *cs command now also supports "long-lat", "s-merc" (for "Web
1979   Mercator"), EPSG and ESRI codes, "eur79z30", "ijtsk" and "ijtsk03".  This
1980   means that we now support all the coordinates systems which Therion does,
1981   except for a few which don't have X=East and Y=North.  The documentation
1982   for *cs has also been improved.
1984 * aven: We no longer persist full screen mode between runs - it's not a
1985   standard behaviour of desktop programs, and it's too easy to go into full
1986   screen mode from the menu and then not be able to get out again because you
1987   don't know the required key shortcut. (ticket#39)
1989 * aven: When in full screen mode, moving the mouse to the top of the screen now
1990   makes the menu bar appear.  This provides a non-shortcut way out of full
1991   screen mode, as well as making it easier to perform other operations while in
1992   full screen mode.  The current implementation gives an annoyingly flickery
1993   transition, but hopefully we can improve this in future. (ticket#39)
1995 * (MacOS X version): If built with wxWidgets >= 3.1.0 (which is still in
1996   development), we now call EnableFullScreenView() which improves the full
1997   screen mode experience on OS X 10.7 and later.
1999 * img library: Improve documentation for img_ERROR_INFO.
2001 * tests/: Ship some missing .out files and compare.tst.
2003 * tests/: cavern.tst testcase back2 is now actually used.  Fix a bug in this
2004   testcase, and extend it to cover a variant of the situation reported as a bug
2005   in therion by Bill Gee to the therion list.
2007 * (Linux version) survex.spec: Add run-time requirement on proj and proj-epsg
2008   for the survex package and on tk for the svxedit package.
2010 Changes in 1.2.14 (2014-07-05):
2012 * img library: Add ability to store a PROJ4 string describing the coordinate
2013   system in use in 3d v8 files.
2015 * aven: If the 3d file specifies a coordinate system, then use it for exporting
2016   to formats which need to know (currently GPX).  If the input file doesn't
2017   specify the coordinate system, allow the user to enter a PROJ4 string in the
2018   export dialog.
2020 * aven: You can now quickly zoom to a particular area by holding down the
2021   "Shift" key and dragging with the left mouse button to create a rectangular
2022   "rubber band box" around the area you wish to zoom to.  If you release the
2023   "Shift" key while still dragging, the box is centred on the start point
2024   rather than having one corner there.
2026 * aven: Fix exporting of passage tubes in elevations and extended elevations
2027   - previously up and down were getting drawn across the page!
2029 * aven: Fix "Cancel" to work on the print/export dialog, broken by changes in
2030   1.2.13.  (Reported by Brian Clipstone)
2032 * aven: Fix the conditions on which the menu item "Cancel measuring line" is
2033   enabled - previously it was hard to actually cancel it via the menu.
2034   Reported by Hugh St Lawrence.
2036 * aven: Fix wx assertion failures when showing hit test debug view on platforms
2037   such as 64-bit Linux.
2039 * aven: When viewing from above, show "Plan" above the "clino" which indicates
2040   the tilt angle (instead of "Elevation -90°").
2042 * aven: The extended font data now loads faster, and also uses less memory on
2043   64-bit platforms.
2045 * aven: Dragging the vertical divider between the side panel and the 3D view
2046   now only updates when you finish the drag, as redrawing continuously just
2047   looks clunky except on an ultra-fast machine.
2049 * aven: (German translation) Abbreviate "Blickrichtung" so it doesn't overfill
2050   the space available in the aven UI.
2052 * cavern: Add a *cs command to allow setting the coordinate system for *fix
2053   commands, and the coordinate system used for processed survey data.  The
2054   latter is now stored in 3d v8 format files.
2056 * cavern: Add support for 'L' flag (exclude from length) in Compass .dat files
2057   and handle it in the same way as the "DUPLICATE" flag in .svx files.
2059 * cavern: If there's more than one *fix command with coordinates, still
2060   actually fix the second and subsequent ones, to avoid triggering bogus errors
2061   about unconnected surveys.
2063 * cavern: If there's more than one *fix command with coordinates, report the
2064   station name of the previous one, plus the file and line number where it was.
2066 * cavern: Fix handling of the rather contrived case of *fix with no coordinates
2067   followed by *solve and then another *fix with no coordinates not to access
2068   freed memory.
2070 * dump3d: Report any specified coordinate system.
2072 * doc/3dformat.htm: Update to document how the coordinate system is stored.
2074 * (Microsoft Windows version): Include dump3d in the installer.
2076 * Fix a compiler warning.
2078 * Improve test coverage.
2080 Changes in 1.2.13 (2014-05-15):
2082 * aven: Fix --print option to wait for printing to happen before exiting
2083   (previously it would exit right after opening the print dialog, so you
2084   couldn't actually print anything out using it).
2086 * aven: Increase the threshold for how close the pointer needs to be to a
2087   station from 5 pixels to 7 to try to help touchscreen users.  Reported by
2088   Hugh St Lawrence.
2090 * aven: Add "fat finger" mode, toggled by pressing F2, to allow investigating
2091   if increasing the minimum pointer to station threshold helps Hugh's problems
2092   with using aven on a touch screen device.
2094 * aven: The measuring line was unable to see stations which had just been
2095   revealed by toggling surface or underground legs on - this is now fixed.
2097 * aven: Add "hit test grid debug" mode, which shows the hit test grid and how
2098   many entries are in each box (toggled by F3).
2100 * aven: Pressing F4 now allows the user to toggle wxWidgets assertion messages
2101   off and back on.
2103 * aven: Create the empty hit-test grid data structure lazily, to reduce start
2104   up time a little.
2106 * cavern: Improve messages which talk about "tags" and/or "prefixes" in *begin
2107   and *end commands to instead talk about "survey names".
2109 * cavern: For ages cavern has warned if you reentered a survey, but this
2110   warning was suppressed if it occurred at the same line of the same file as
2111   the survey was first entered, but this can only happen if you include the
2112   same survey file more than once, which isn't a sensible thing to do for a
2113   file with actual survey data in (you might reasonably do it to set up survey
2114   grade details or something like that).  The warning is now given in this
2115   situation too.
2117 * cavern: After 5 warnings about reentering a survey we give up warning about
2118   it, but we used to keep reporting where the survey was originally entered -
2119   this secondary diagnostic message is now silenced when the main message is.
2121 * (Microsoft Windows version): Compile C code with optimisation on.
2123 * Add the start of a Russian translation, with messages take from therion.
2125 * Minor translation updates to French.
2127 * Fix compiler warning from GCC.
2129 * Testsuite improvements:
2131   + Test that "..." anon station works.
2133   + cavern.tst: Check number of errors returned by all testcases which should
2134     fail and give an error count.
2136   + cavern.tst: Fix to actually fully test everything when builddir != srcdir.
2138 Changes in 1.2.12 (2014-04-14):
2140 * aven: Fix measuring line to show change in altitude rather than altitude
2141   itself (accidentally broken by changes in 1.2.11).  Reported by Brian
2142   Clipstone.
2144 * aven: Fix printing when built with wxWidgets 3.0.
2146 * aven: Several visual improvements to printouts:
2148   + Move the numbers below the scale bar down a little so that they don't
2149     overlap the scale bar ticks.
2151   + Set the clipping region after we draw the page border and info box to avoid
2152     clipping the border in print preview.
2154   + Tidy up the appearance of the compass and elevation arrow.
2156 * aven: Fix to build with libav 10.  Reported by Moritz Muehlenhoff in
2157   <http://bugs.debian.org/739332>.
2159 * aven: Fix to build with older libav where avcodec_free_frame() isn't
2160   available.
2162 * (Linux version) survex.spec: Update spec file used for building RPM packages.
2164 * (Unix version): Add "Keywords:" entry to .desktop files.
2166 * (Unix version): Enable large file support, mostly to support filing systems
2167   which return 64 bit inode values, such as CIFS mounts.
2169 * (Microsoft Windows version): Only allow "A-Z" or "a-z" for driver letters,
2170   rather than any character which is a letter in the current locale.
2172 * Various translation updates.
2174 Changes in 1.2.11 (2014-01-28):
2176 * aven: Fix wxWidgets assertion when double clicking on an anonymous station.
2177   Reported by Kevin Dixon.
2179 * aven: Embed the font data for the first 256 Unicode characters for use in the
2180   survey pane into the compiled aven binary to reduce start up overhead.  Any
2181   additional characters needed are loaded from a data file only if/when a
2182   character >= U+100 is actually needed (as before).
2184 * aven: Fix display of Unicode characters above 256 when there's a character
2185   <= 256 earlier in the same string.
2187 * aven: Use the actual width of Unicode characters above 256 rather than
2188   assuming they are 16 pixels wide.
2190 * aven: If full screen, don't show the side panel when a new file is opened
2191   (e.g. via Ctrl+O).
2193 * aven: Don't give an assertion failure when showing passages for a cave with
2194   no vertical extent.  Reported by Jonny Prouty.
2196 * aven: Change terminology in print dialog - say "legend" instead of "info
2197   box".
2199 * aven: Add option to show the tilt angle as a percentage gradient.
2201 * aven: Show the units (degrees, grads, or percent) for the tilt and bearing
2202   indicators.
2204 * aven: All length units are now translatable.
2206 * aven: Split log_fl_error helper function out of CHECK_GL_ERROR macro, which
2207   will reduce code size and also the number of deprecation warnings about
2208   gluErrorString on Mac OS X 10.9.
2210 * (Microsoft Windows version): aven: Try to work around redraw issues related
2211   to the measuring line by redrawing the whole window, which doesn't seem to be
2212   measurably slower.
2214 * cavern: If *units is used to try to set units for LEVEL, PLUMB, or POSITION,
2215   give an error rather than quietly ignoring the attempt.
2217 * cad3d: Make cad3d remap control characters and spaces in station names when
2218   generating PLT output in the same way aven does.
2220 * Various translation updates (particular thanks to Eric Madelaine and Dennis
2221   Baudys), including the start of a Bulgarian translation, with messages taken
2222   from Therion and elsewhere.
2224 * (Microsoft Windows version): On Microsoft Windows 2000 and newer, use
2225   GetUserDefaultUILanguage() to get the UI language to use.  For older
2226   versions, continue to use GetUserDefaultLCID().
2228 * (Microsoft Windows version): The Indonesian translation will now be used
2229   automatically when the system language is set to Indonesian.
2231 * (Mac OS X version): Fix to build with wx 3.0.0 on OS X 10.9.  Thanks to David
2232   A. Riggs for his work on this.
2234 * (Mac OS X version): Update buildmacosx.sh script to use wx 3.0.0, and add a
2235   checksum check for the downloaded wx sources.
2237 * Fix a lot of the compiler warnings when building with clang.
2239 * doc/manual.sgml: Add missing quantities to the list documented as accepted by
2240   *units: LEFT, RIGHT, UP/CEILING, DOWN/FLOOR (missing entirely);
2241   BACKCOMPASS/BACKBEARING, BACKCLINO/BACKGRADIENT (missing from the main list,
2242   mentioned in list of the units that can be set for them); COUNT (missing
2243   alternative name for COUNTER); DX/EASTING, DY/NORTHING, DZ/ALTITUDE
2244   (incorrectly listed as X, Y, Z).  Reported by Jonny Prouty.
2246 * Test suite: Improve test coverage for cavern.
2248 Changes in 1.2.10 (2014-01-15):
2250 * aven: Fix assertion if two mouse buttons are held down at the same time.
2251   If dragging with more than one mouse button held down, releasing one causes
2252   another which is still held down to take effect.  Reported by Brian
2253   Clipstone.
2255 * aven: If we fail to start the external editor when the user clicks on an
2256   error or warning from cavern, show an error box.
2258 * aven: If the survey has a title, add it as a top-level <title> element to
2259   exported SVG files.
2261 * aven: Escape '<', '>', and '&' in labels in exported SVG files.
2263 * aven: In GPX export, set the <time> element to the datestamp from the 3d
2264   file.
2266 * aven: Don't try to write the title if it isn't set or is empty when exporting
2267   GPX files.
2269 * aven: Don't bother looking up the printer page setup info when exporting.
2271 * (Microsoft Windows version): aven: Fix crash on "File->Print" or
2272   "File->Export" under Windows XP, reported by Brian Clipstone.
2274 * (Microsoft Windows version): aven: Fix error dialog about an incorrectly
2275   encoded filename which could occur if run without being asked to load a file
2276   on startup.
2278 * (Microsoft Windows version): aven: Compile with optimisation on.
2280 * img library, aven: Although processed CMAP data files are often referred to
2281   as "CMAP .XYZ files", it seems that actually, the extension .XYZ isn't used,
2282   rather .SHT (shot variant, produced by CMAP v16 and later), .UNA (unadjusted)
2283   and .ADJ (adjusted) extensions are.  Since we've long checked for .XYZ, we
2284   continue to do so in case anyone is relying on it, but also check for the
2285   other extensions.
2287 * img library: Add new "datestamp_numeric" field to struct img giving the
2288   datestamp as a time_t in UTC (or (time_t)-1 if there's no datestamp or we
2289   failed to convert it).  For .3d >= v8, this field is reliable.  We attempt to
2290   convert date strings in .3d <= v7 and CMAP XYZ files, but may get the
2291   timezone wrong.
2293 * img library: Fix my_strcasecmp() to handle top-bit set characters better.
2295 * cavern: Fix NULL pointer dereference when processing Compass DAT file without
2296   'SURVEY DATE:'.
2298 * doc/manual.sgml: Update references to Survex 1.1 which should be to 1.2.
2300 * doc/manual.sgml: Note the station length limit Smaps used.
2302 * Fix some compiler warnings if built with glibc's fortify source feature
2303   enabled.
2305 Changes in 1.2.9 (2014-01-08):
2307 * Document --3d-version in cavern man page and the manual.
2309 * aven: Fix compilation error in movie export code with recent libavi.
2311 * aven: Fix warning on stderr when export a movie as MPEG.
2313 * img library: In non-hosted mode, don't define GETC and PUTC if they're
2314   already defined, to allow easy overriding with getc_unlocked() and
2315   putc_unlocked() (which are significantly faster on Linux).
2317 * img library: In non-hosted mode, check that int is at least 32 bits,
2318   and if not, use long.  In practice, platforms with 16 bit int are mostly
2319   obsolete, but it's not hard to be portable here.
2321 * img library: Add test that img.c and img.h compile in non-hosted mode
2322   (regression test for issue fixed in 1.2.8).
2324 * (Microsoft Windows version): aven is now built with wxWidgets 3.0.0.
2326 * Update translations from launchpad and from existing similar messages.
2328 * Fix some compiler warnings.
2330 Changes in 1.2.8 (2013-10-29):
2332 * cavern: Fix handling of anonymous wall stations ('..' by default) to
2333   implicitly set the SPLAY leg flag, as was intended.  Reported by Thomas
2334   Holder.
2336 * cavern: Tweak .err file output not to lose the space in front of certain
2337   statistics when the value gets large.
2339 * cavern: Eliminate redundant progress message when solving simultaneous
2340   equations.
2342 * aven: Add a format drop down to the export dialog, and only show fields which
2343   are meaningful and supported for the currently selected export format.  The
2344   format defaults to that used most recently.  The "Elements" and "View" boxes
2345   have been swapped in the print and export dialogs as that layout works much
2346   better when the "View" box is hidden.
2348 * aven: Changing checkboxes in the print or export dialog didn't work in 1.2.7
2349   - now works again.  Reported by Anthony Day.
2351 * aven: Add GPX export (based on findentrances patch from Olaf Kähler).  In
2352   this release the projection which the survey coordinates are in defaults
2353   to the BMN M31 grid used in the Totes Gebirge in Austria.  On Unix, you
2354   can edit ~/.aven and add a new line setting 'input_projection' to a PROJ
2355   projection string.  The ability to specify this projection in a better
2356   way is coming soon.
2358 * aven: New export options "Origin in centre" and "Full coordinates" - the
2359   latter fixes #10.  GPX and PLT output implicitly force "full coordinates".
2361 * aven: The "Sketch" vector drawing program got renamed to "Skencil" some
2362   time ago, so update references.
2364 * aven: Make the Presentation->Play menu item a checkbox, to avoid a warning
2365   with wxMSW 2.9.5.  Reported by Brian Clipstone.
2367 * aven: Make right click in an empty presentation mark the current position and
2368   open it to edit, instead of crashing.
2370 * aven: Update movie export code to work with latest libav API.  Reported by
2371   Sebastian Ramacher.
2373 * aven: Improve reporting of errors during the process of exporting a movie.
2375 * aven: Don't try to close the movie if we aren't producing one.
2377 * aven: Fix assertion failure when double-clicking on the survey with wx2.9.
2379 * aven: Fix to build with wxMSW 2.9.5.
2381 * aven: Fix to build with wx 2.9.5 with wx2.8 compatibility disabled.
2383 * cad3d: The "Sketch" vector drawing program got renamed to "Skencil" some time
2384   ago, so add a new --skencil option to specify this output format.  The old
2385   name (--sketch) is still recognised for compatibility.
2387 * cad3d: Make --marker-size work for Skencil and SVG output.
2389 * dump3d: Make --show-dates option show dates for XSECT.
2391 * img library:
2393   + Fix to work once more when used outside of Survex (missing definition of
2394     max() macro and a bad call to free() in img_close() for a file opened for
2395     reading).
2397   + Use lround() instead of round(), and make the tests around whether we use
2398     the library function or the our fallback implementation saner.
2400   + Fix // comments in C code for portability to pre-C99 compilers which don't
2401     support these as an extension.
2403   + Can now be compiled as C++ as well as as C.
2405 * (Microsoft Windows version): The installer is now built with a newer version
2406   of Innosetup, and includes translations for all the languages which Survex
2407   itself has any translations for.
2409 * (Microsoft Windows version): aven is now built with wxWidgets 2.9.5.
2411 * Minor translation updates.
2413 * tests/Makefile.am: Distribute files for "normal_bad" testcase.
2415 Changes in 1.2.7 (2013-07-27):
2417 * Add support for anonymous stations, which are indicated by one, two or three
2418   separator characters - with the default separator of '.', that means '.',
2419   '..', and '...' are anonymous stations.  Single separator ('.' by default)
2420   is an anonymous non-wall point, double separator ('..' by default)
2421   is an anonymous wall point at the end of an implicit splay), and triple
2422   separator ('...' by default) is an anonymous point (with nothing special about
2423   the leg).  A new *alias command allows '-' to be mapped to '..' for
2424   compatibility with pocket topo: *alias station - ..
2426 * New version 8 of the 3d format:
2428   + Supports new flags img_SFLAG_ANON and img_SFLAG_WALL.
2430   + New explicit file-wide flag for 'this is an extended elevation', rather
2431     than modifying the survey title to indicate this.
2433   + The survey prefix is often unchanged from one leg to the next, so use a
2434     spare flag to compactly indicate when there's no label change.
2436   + The data style of each leg is now stored.
2438   + The "processed at" time is stored as seconds since 1970 rather than a
2439     human-readable string.
2441   + Since 3d v8 features significant changes to the format, the format
2442     documentation for v7 and earlier has been split off into 3dformat-old.htm.
2444 * img library:
2446   + New station flags img_SFLAG_ANON and img_SFLAG_WALL.
2448   + Handle .pos files containing unnamed stations - don't suck the next line in
2449     as the station name, and set img_SFLAG_ANON for them.
2451   + Repurpose the long unused fBinary parameter to img_open_write() as a flags
2452     parameter, and add img_FFLAG_EXTENDED to specify that this is an extended
2453     elevation, in place of appending " (extended)" to the title.  Internally we
2454     still append this to the title (and remove it upon reading) when writing
2455     3d v7 or earlier, but for the new 3d v8 format, this flag is stored
2456     explicitly in the file.
2458   + img.h: Add comments for the lists of "Leg flags" and "Station flags".
2460 * aven:
2462   + We now require at least wxWidgets 2.8.0 - it was released over 6 years ago
2463     now, and the wx developers consider even 2.8 to be rather long in the
2464     tooth.  We stopped testing building with wxWidgets 2.6 some time ago, and
2465     formally dropping support for older versions allows a number of workarounds
2466     to be removed from the aven source code.  Also, features deprecated in
2467     wxWidgets 2.9 are no longer used in our code.
2469   + Don't run incremental search on every key-press, as on a slow machine the
2470     short initial search(es) will take a while but not be useful.  Instead only
2471     actually run the search when we're told there are no more key-presses
2472     queued up.
2474   + Implement support for including cross-section information in exported SVG
2475     and DXF files (ticket#4).  The DXF export is untested currently.
2477   + Show splay legs faded by default, with menu options to hide them or show
2478     them like other legs.
2480   + Speed up loading a .3d file with cross-sections by using a map to convert
2481     station names to positions.
2483   + In the cavern log window, don't highlight a file:linenumber if there's no
2484     message after it, which avoids highlighting the "Included from" lines
2485     wrongly.
2487   + Fix not to crash when trying to report an error while starting up.
2489   + (MacOS X version): Change the menu shortcut for "Full Screen Mode" to be
2490     the OS X standard shortcut Shift-Command-F (previously we used F11, but
2491     that's used by the desktop).
2493   + Add checks for errors when reading the font file.
2495   + Remove useless extra quoting when invoking vim to show the location of an
2496     error from cavern.
2498   + Include GL/gl.h before GL/glext.h (needed on Debian wheezy).
2500   + Use wxValidator to simplify keeping svxPrintDlg member variables and fields
2501     in the dialog in sync.
2503 * cavern:
2505   + Demote errors about invalid dates to warnings, since we've accepted *date
2506     for ages without any checks on the value, and so existing datasets
2507     probably contain invalid dates and dates in other formats.  (ticket#19)
2509   + New *alias command allows '-' to be mapped to '..' for compatibility with
2510     pocket topo: *alias station - ..
2512   + We want to warn if there's a clino reading which it would be impossible to
2513     have read from the instrument (e.g. on a -90 to 90 degree scale you can't
2514     read "93" (it's probably a typo e.g. for "39").  However, the gradient
2515     reading from a topofil is typically in the range 0 to 180, with 90 being
2516     horizontal.  Really we should allow the valid range to be explicitly
2517     specified, but for now we infer it from the zero error - if this is within
2518     45 degrees of 90 then we assume the instrument can read between 0 and 180
2519     degrees.
2521   + If the survey isn't all connected, still run survey tree checks and report
2522     errors and/or warnings which might suggest typo locations.  Thanks to Kevin
2523     Dixon for the report which highlighted this issue.
2525   + Report a warning if *begin SURVEY has a separator character in SURVEY.
2527   + Report column numbers as well as line numbers for some cavern errors and
2528     warnings.
2530   + Adjust width of node stats table to fit longest count when there are more
2531     than 9999 of a particular order of node.
2533   + If the argument to *include has an opening double quote but the closing
2534     double quote is missing, then skip trying to open the file.
2536   + Move "Station X referred to just once" warning after non-existent survey
2537     check - if both fire, the non-existent survey error is likely to be more
2538     relevant.
2540   + We no longer follow an error for a bad reading in passage data with a bogus
2541     "End of line not blank" error, but instead check the remaining readings on
2542     the same line.
2544   + We no longer follow an error about OMIT for a required reading with a bogus
2545     "End of line not blank" error.
2547   + Report an error if the scale factor in *calibrate is zero - it doesn't make
2548     sense and probably means someone reversed the arguments to *calibrate.
2550   + Report the parent include files starting from the outermost, as that's more
2551     logical when there are multiple levels involved.
2553   + If we were expecting a numeric field and instead get something which starts
2554     with '+', '-', or '.' but which isn't a number, then fix the error to
2555     include that character in the token reported.
2557   + Simplify handling of quantity lists to only recognise 'DEFAULT' as the
2558     first item.
2560 * cad3d: Check for errors from img_rewind() and report them.
2562 * dump3d:
2564   + Build, install and package dump3d as standard - it's useful for grabbing
2565     info from 3d files in scripts.
2567   + Add --show-dates option.
2569   + Show only 2 decimal places on coordinates and passage dimensions.
2571   + Report the data style of legs.
2573   + Report if the file is an extended elevation.
2575   + Report img_STOP as STOP rather than CODE_0xffffffff.
2577 * Test suite:
2579   + cavern.tst: Fix equatenosuchstn testcase (added in 1.2.6) to normalise the
2580     expected output so it passes reliably.
2582   + cavern.tst: Run diffpos <expected> <actual> so the reports of 'Added' and
2583     'Deleted' stations upon failure are the more natural way round.
2585   + Add more testcases, expand some existing testcases, and add expected output
2586     for more.
2588 * (Microsoft Windows version): Use wx-config's --cc and --cxx flags to find the
2589   appropriate C and C++ compilers to use, and link mingw build statically to
2590   avoid needing the libgcc DLL (which newer GCC seems to have by default).
2592 * (Unix version): When determining the character set for command-line tools,
2593   check environmental variable LANG after LC_ALL and LC_CTYPE.
2595 * When determining the language, check environmental variable LC_ALL before
2596   LC_MESSAGES and LANG (but after SURVEXLANG).
2598 * If we don't find the message file, only give an error if it was specified
2599   with SURVEXLANG, since that is an explicit instruction to Survex, whereas
2600   LANG, LC_ALL and LC_MESSAGES are essentially system "preferred locale"
2601   settings.
2603 * There are a handful of hard-coded English message strings for reporting
2604   errors trying loading message files, etc.  These are all now ASCII, as if we
2605   fail trying to open a message file, it's more likely the encoding isn't
2606   set correctly.
2608 * Prune strings we are no longer using and are probably unlikely to use again
2609   into a new file po_codes_dead, so that translators don't get presented with
2610   them to translate.
2612 * Merge lots of translation updates.  Most translations are now complete or
2613   close to complete.
2615 * Add start of Indonesian translation from Arief Setiadi Wibowo.
2617 * Fix various compiler warnings when building from source.
2619 * Include scripts gdtconvert and gen_img2aven in the source distribution.
2621 Changes in 1.2.6 (2012-02-23):
2623 * (Mac OS X version): Fix so that cavern finds its messages when run by aven.
2625 * (Microsoft Windows version): Include JPEG images for aven in the installer
2626   package (ticket#35).
2628 * cavern: If we have a reference to a station in a non-existent survey, give a
2629   helpful error rather than saying the station hasn't been exported from the
2630   survey.  (Bug reported by Martin Green via email)
2632 * aven: Fix to build with a non-Unicode wxWidgets library.  Patch from Olaf
2633   Kahler.
2635 * findentrances: Add findentrances utility from Olaf Kahler which produces a
2636   .gpx file with waypoints for entrances.  This needs libproj so is disabled
2637   by default for this release - to enable it install the development stuff for
2638   libproj and build survex with:
2640       make FINDENTRANCES=findentrances
2641       make install FINDENTRANCES=findentrances
2643 * dump3d: Add support for showing img_ERROR_INFO items.
2645 * doc/3dformat.htm: Merge in some improvements from Mike McCombe.
2647 * Incorporate a French translation from launchpad I'd previously copied the
2648   English version of by mistake.  Attempt to correct mistranslation of "survey
2649   file".
2651 Changes in 1.2.5 (2012-01-03):
2653 * aven:
2655   + The survey tree in the left panel is now in sorted order once more.
2657   + No longer fails with an assertion if used for a long time (we were leaking
2658     an OpenGL list each time one had to be regenerated).
2660   + Now builds with newer FFmpeg library.
2662   + Draw measuring line in front of the indicators rather than behind them.
2664   + Loading a new file (or reloading the current one) no longer invalidates
2665     the OpenGL lists for the compass and clino, so will be a fraction faster.
2667 * Improve handling of attempts to look up translated messages before the
2668   message subsystem is fully initialised (which only happens if there's an
2669   error early on).
2671 * Improve the survex(7) man page text, and fix it to be marked as section 7 in
2672   the man page source as well as in the filename.
2674 Changes in 1.2.4 (2012-01-01):
2676 * aven:
2678   + A change in 1.2.3 meant that aven tried to use OpenGL before it was
2679     initialised, which doesn't cause problems in some machines, but causes aven
2680     to abort on others.  This is now fixed, and there's a check in place to
2681     help avoid similar issues in future. (ticket#34)
2683   + Always use metres or feet for the depth colour key, and chose a consistent
2684     precision by looking at the depth range. (ticket#30)
2686   + Show the depth units below the colour bar rather than after every value.
2688   + When zooming way in, stay in metres rather than switching to cm.
2690   + On the scale bar, say “1 mile” rather than “1 miles”.
2692 * Translation updates for Catalan, French and Slovak.
2694 Changes in 1.2.3 (2011-12-31):
2696 * Fix to build with wxWidgets 2.9.2.
2698 * (Mac OS X version):
2700   + Processing .svx files from aven now works.
2702   + Remove spurious blank lines from the licence text in "Get Info".
2704   + Don't create the help menu at all, as it is empty (because the "About"
2705     entry goes elsewhere) and sometimes seems to appear in the UI.
2707   + INSTALL.OSX: Update to reflect current status.
2709 * aven:
2711   + Fix Y coordinates of surface surveys on printouts.  (Closes #32)
2713   + Improvements to text plotted on the survey pane:
2715     - Support plotting Unicode character points > 256 by lazily loading the
2716       data for them from the font file and plotting them with a direct call to
2717       glBitmap(), which is slower but doesn't require a display list per
2718       character.
2720     - Adjust the spacing from fixed width to putting a one pixel gap either
2721       side of each one character (so two between adjacent glyphs).  Mostly this
2722       reduces the horizontal width, but it adds a pixel for characters like "m"
2723       and two in a few cases.
2725     - Fix .pixelfont file generation to correctly handle characters wider than
2726       8 pixels.
2728   + Fix expected cross shape so don't always reject using texture mapping to
2729     draw crosses.
2731   + As we read a survey file, eliminate tubes consisting of zero XSECTs as well
2732     as those consisting of just one.  Previously we would trip over the empty
2733     tube later.  Such tubes can for example be created by extend if a splay shot
2734     is the start or end of a tube.
2736   + Make the green colour used for entrances in the survey tree the same
2737     (slightly darker than before) green used for the entrance blobs.
2739   + Report the version of the library we're actually running with if built
2740     against wx >= 2.9.2.  Make it clear that the version reported is the
2741     version *built* with for wx < 2.9.2.
2743 * extend:
2745   + Copy the end markers for passage tubes.
2747   + Preserve left and right data for tubes (previously they were set to -1.0
2748     which means "no info").
2750 * img library: Fix incorrect comment in img.h which claimed that img_XFLAG_END
2751   was no longer used - it certainly is!
2753 * Use curly double quotes instead of "`" and "'" to quote filenames, etc in
2754   messages, and curly single right quote instead of straight ASCII apostrophe.
2755   Fall back to using straight ASCII versions if we can't represent them in the
2756   current character set.
2758 * Translation updates for Catalan, French, Slovak and Spanish.
2760 * Test suite:
2762   + Add test coverage for interleaved diving data.
2764   + Add testcase for diving data with topofil-style distance.
2766 Changes in 1.2.2 (2011-10-06):
2768 * aven:
2770   + Replace the textured-mapped font drawing with an approach based on
2771     glBitmap.  This doesn't suffer from the character alignment issues which
2772     the textured-mapped fonts had, and is actually significantly faster on some
2773     machines.  The current font used is (mostly) fixed-width, but this isn't an
2774     inherent limitation - it was just the easiest font data to convert to a
2775     usable format.
2777   + Fix assertion failure due to rounding differences on loading certain .3d
2778     files.  (ticket#26)
2780   + Fix assertion failure when turning on 3D passages if they stick out higher
2781     or lower than any station.  (ticket#29)
2783   + Fix grid not to disappear when blobs are turned on and blobs are drawn
2784     using lines.
2786   + If a degree sign isn't available in the character set in use, transliterate
2787     it to 'dg' rather than skipping it.
2789   + Fix message which should have been a degree sign but got lost in the format
2790     change for 1.2.0 and then got reassigned in 1.2.1.  Externally, this means
2791     that bearings in the status bar now have a degree sign after them if they
2792     are in degrees rather than nothing (1.2.0) or "&Hide Compass" (1.2.1).
2794   + Fix print dialog to calculate the scale required for "One page" right
2795     before it calculates how many pages are required, so we don't end up
2796     something other than 1x1 being shown when the user changes settings.
2798   + Update the calculations for picking a scale and for deciding how many
2799     pages are needed to take into account the change in info box height made
2800     in 1.2.1.
2802 Changes in 1.2.1 (2011-10-04):
2804 * Translation updates for US English.
2806 * aven:
2808   + Rename the "depth bar" to "colour key" in documentation, menus, etc since
2809     it now shows colours for dates and errors as well as depths.
2811   + In the colour key for "colour by date", change "No info" to "Undated".
2813   + Remove the dark grey background from the colour key and just put a single
2814     pixel black border around the colours.  This is more in keeping with the
2815     other controls, and means the colours are now on a black background so more
2816     visually similar to the survey legs.
2818   + Move the colour key's "Undated"/"Not in loop" entry down a little to
2819     improve the appearance.  Make each section a pixel taller.
2821   + Allow "Colour by X" to be selected even if there's no data for X or only a
2822     single value of X used (the colour key is much smaller in these cases, and
2823     does still provide some useful information).
2825   + Fix incorrect calculation of depth colouring for survey legs which straddle
2826     a depth band boundary.
2828   + The scale bar, compass, clino, and colour key now all have right click
2829     menus which allow related actions to be performed (especially handy in
2830     full-screen mode).
2832   + Improve the font used on the survey pane - it now contains the '-'
2833     character (so the clino now shows negative angles as negative, and dates
2834     in the colour key are now hyphenated).  Also the spacing and alignment
2835     are a little better, though still not perfect.
2837   + PLT file export now handles spaces and control characters in station names
2838     by escaping them with '%' as in URLs.
2840   + Pressing "Enter" on a station in the tree control now centres the view on
2841     that station.
2843   + The scale bar is now cached in an OpenGL display list since it often gets
2844     redrawn exactly the same - for example, when rotating, panning, etc.
2846   + Pressing "F5" forces all cached OpenGL drawing lists to be invalidated and
2847     then forces a refresh of the survey pane.  This is intended as a debugging
2848     aid - if pressing F5 changes the display at all then there's a missing case
2849     where a list should have been invalidated (please report if you find such
2850     a case as it is a bug).
2852   + We now automatically track which OpenGL display lists need to be
2853     invalidated on window width or height changes.
2855   + Increase scale bar maximum width from 65% of the window width to 75% as it
2856     was in 1.0.x (except that if that would overlap the clino we now reduce
2857     that proportion down until it reaches 50%).  Make the limit of zooming in
2858     the same as in 1.0.x.  (ticket#23)
2860   + (Linux version): Previously wxGTK didn't really handle showing a dialog if
2861     the application was fullscreen (the dialog got opened under the main
2862     window!)  To work around this, aven would switch out of full screen mode
2863     temporarily while showing a dialog.  This case works properly with recent
2864     wxGTK, so disable our workaround with versions we know work.  Also, apply
2865     the workaround only for wxGTK, not everywhere except on Microsoft Windows
2866     as there's no reason to think we need it for other platforms.
2868   + Grey out the "View North" action when we're already viewing North, and
2869     similarly for other compass points.
2871   + (Mac OS X and Microsoft Windows versions): Fix missing newline to OpenGL
2872     info in the "About" dialog.
2874   + Fix to set the correct filename on the root of the survey tree - previously
2875     the filename of the previous file loaded was used!
2877   + The movie export code now works with newer versions of the FFmpeg libraries
2878     as well as still working with older versions.
2880   + Fix mixed up messages - the print dialog now says "View" on the left
2881     subgroup of controls rather than some unrelated message.
2883   + On printouts, combine the "Plan View"/"Elevation" info box field with the
2884     field which gives the bearing and reduce the height on the info box by the
2885     removed field, so it's now 3cm for plans and elevations, as for extended
2886     elevations.  Report the tilt angle for tilted elevations which it seems has
2887     been missing for ages (it's not in recent 1.0.x either).
2889   + Tweak the exact positioning of informational text on printouts to look
2890     nicer and make better use of the available space.
2892   + Add keyboard mnemonics to the "Plan" and "Elevation" buttons in the print
2893     dialog.
2895   + Make the sign of the tilt angle for printouts consistent with the sign
2896     shown by the "clino" in the survey pane.
2898   + In the "Print" dialog, when in plan view disable the "Plan view" button,
2899     and similarly for the "Elevation" button.
2901   + (Microsoft Windows version): Sort out appearance of custom cursors.
2903   + If a label isn't valid UTF-8 or CP1252, fall back to ISO8859-1.
2905   + (Mac OS X version): F11 puts aven into full screen mode, but apparently
2906     you can't get out again easily, so add code to explicitly check for F11
2907     being pressed and toggle full screen.
2909 * (Linux version): Fix the RPM .spec file for where man pages now get installed
2910   and package aven.svg and the vim support files.  (Fixes from James Begley)
2912 * "make check" now performs several checks on the translation files.
2914 * More messages are now available to be translated.
2916 * cavern: Fix reporting of ranges of survey coordinates, which was broken by
2917   the message handling changes in 1.2.0.
2919 * Fix warning when compiling with GCC.
2921 * INSTALL: Mention building wxWidgets with --enable-unicode.  Mention using
2922   sudo for installing on Unix.
2924 * In the manual, replace the instructions for building from source with a
2925   pointer to the clearer instructions in INSTALL.
2927 * In the manual, make it clear that installing with administrator rights
2928   also applies to newer platforms than XP.
2930 * doc/TODO.htm: Update.
2932 Changes in 1.2.0 (2011-09-20):
2934 * Translation updates for Catalan, French, Romanian, Spanish, Slovak, and US
2935   English.
2937 * tests/smoke.tst: aven no longer requires an X display for --help or
2938   --version, so replace skip of this check with a check that this remains the
2939   case.
2941 * We now use the standard .po and .pot file formats for storing translations
2942   (rather than the Survex-specific messages.txt format), and then translate
2943   these into Survex's .msg format.
2945 * (Unix version): Move survex man page to section 7 (since it isn't documenting
2946   an actual command).
2948 * (Unix version): Write each generated man page to a temporary file, then
2949   atomically rename, to avoid leaving an empty or partial man page behind if
2950   docbook-to-man dies (1.1.16 had an empty cad3d.1, and we want to avoid a
2951   recurrence of that).
2953 * (Unix version): Default to installing docs into /usr/share/doc/survex rather
2954   than /usr/doc/survex.
2956 * aven:
2958   + Fix handling of accented characters in the survey pane.
2960   + Aven icon redrawn in SVG format - it's now a vector image which looks
2961     nicer at larger sizes.
2963   + Explicitly request double-buffering, which seems to be needed for systems
2964     with GLX >= 1.3.
2966   + Fix crash while trying to load certain .3d files.
2968   + Movie export code updated to work with more recent versions of FFmpeg.
2969     Currently this is disabled in Microsoft Windows builds, pending getting the
2970     required libraries set up for building releases.
2972   + Reporting of errors during movie export improved.
2974   + Force playback speed to "x1" during movie export.
2976   + Use stock IDs for buttons where appropriate - such buttons may now be
2977     rendered with icons on some platforms.
2979   + If a label isn't valid UTF-8, treat it as CP1252 (the Microsoft superset of
2980     ISO8859-1).
2982   + (Unix version): Remove special handling for toggling "full screen" on wxGTK
2983     as it's no longer required with modern versions.
2985   + Don't redraw the survey on every mouse movement in the survey pane unless
2986     the measuring line is (or just was) active.  (ticket #17)
2988 * cavern:
2990   + Drop "non-fatal" from the report of how many errors there were at the end
2991     of the run - it just confuses users - we won't even get here if there's a
2992     fatal error!
2994   + Add --3d-version option to allow the user to specify the version of the 3d
2995     format to output.  (ticket#21)
2997 * img library:
2999   + Make the highest and lowest valid values for img_output_version available
3000     in img.h as IMG_VERSION_MIN and IMG_VERSION_MAX.
3002 * (Mac OS X version): Fix buildmacosx.sh script to check where the temporary
3003   volume actually gets mounted.  Fix URL for downloading wxWidgets.
3005 Changes in 1.1.16 (2011-05-16):
3007 * Translation updates for German, Spanish, Italian, Portuguese, Brazilian
3008   Portuguese, and US English.
3010 * Use horizontal ellipses character rather than '...' and right arrow character
3011   rather than '->' where these characters are available.
3013 * (Unix version): Link with -lGL, if it exists, to support linking with gold or
3014   GNU ld --as-needed (Debian bug #615781).
3016 * img.c:
3018   + Fix code typo for IMG_API_VERSION == 0 case.
3020   + Fix code typo in code used when IMG_HOSTED isn't defined.
3022 * doc/TODO.htm: Remove entries which have now been done.
3024 * (Microsoft Windows version): aven: We now include all the available
3025   translations for messages from wxWidgets, which means that standard widgets
3026   will appear translated where available even if Survex messages aren't
3027   translated.
3029 Changes in 1.1.15 (2010-10-15):
3031 * aven:
3033   + In the cavern log window, change the "Rerun" button to "Reprocess" to
3034     follow terminology in manual and elsewhere.  Fixes ticket#15.
3036   + When displaying output from cavern, don't update the window after every
3037     line, but only when we don't have data from cavern pending.  Hopefully
3038     addresses ticket#12.
3040   + If we aren't using GL_POINTS for blobs, draw them using a series of
3041     abutting lines rather than with gluDisk which is faster and gives a
3042     consistent shape.
3044   + Check whether blobs and crosses actually render correctly as points/point
3045     sprites, and if they don't, fall back to drawing them with lines.  The
3046     best method is cached on disk, and rechecked automatically if the graphics
3047     hardware is changed or the drivers upgraded.
3049   + Fix non-USE_FNT case to work again (it's limited to ISO-8859-1 characters
3050     though, so we still enable USE_FNT by default).
3052   + Don't offer "All files" wildcard in presentation save dialog.
3054   + (Microsoft Windows): Handle filenames with non-Latin1 characters in in
3055     more places.
3057   + (Microsoft Windows): Quote filenames with spaces and metacharacters in
3058     when running cavern from aven.  Fixes ticket#11.
3060 * editwrap: (Microsoft Windows): Handle filenames with non-Latin1 characters.
3062 * diffpos: Handle files with duplicate labels in better - extend generates
3063   duplicate labels when it breaks a loop.
3065 * Enable eswap-break testcase now that diffpos handles duplicate station names.
3067 * New v7 of .3d format which stores survey dates as number of days since
3068   January 1st 1900, so we now support dates from 1900-2078 (rather than
3069   1970-2037) with a smaller file size.  The img API is now versioned - you
3070   can select the new "version 1" by compiling with -DIMG_API_VERSION=1, which
3071   gives the survey dates in days in days1 and days2 instead of as time_t
3072   values in date1 and date2.  Fixes ticket#14.
3074 * Consistently use http://survex.com/ rather than http://www.survex.com/ - the
3075   former has been the canonical name for some time, with www.survex.com just
3076   redirecting to it.
3078 * (Unix version): Use unlocked file I/O if available, which can be much faster
3079   in some cases (we don't need the locking as we don't do multithreaded file
3080   I/O).
3082 * (Mac version): Fix compilation failure due to clash with Point in Mac OS X
3083   headers.
3085 * (Mac version): buildmacosx.sh now works again.
3087 * Most tests weren't actually running any testcases (looks like a sh
3088   portability issue).  This is now fixed, and fortunately all tests still pass.
3090 * Include the extra .isl translation files for Innosetup in the source archive.
3092 Changes in 1.1.14 (2010-07-26):
3094 * Restore compatibility with wxWidgets 2.6 (1.1.13 required wxWidgets 2.8).
3096 * aven:
3098   + After processing survey data, if there were warnings or errors, add a
3099     "Rerun" button to allow easy reprocessing after fixing problems.  If there
3100     were only warnings, also add an "OK" button to allow moving on to viewing
3101     the processed survey data (fixes ticket#13).
3103   + Optimise updating of the cavern log window (hopefully fixes ticket#12).
3105   + Fix links in cavern log window to link from exactly '<file>:<line>' (and
3106     not the ': ' after), and to make the title for the terminal the
3107     warning/error message.  Avoid false positives by checking that '<line>' is
3108     a number.
3110   + Don't double escape the contents of href and target in links in the cavern
3111     log window.
3113   + Improve handling of the splitter window, fixing behavioural glitches in
3114     various cases.
3116   + Highlight stations matching any current search when a file is loaded.
3117     (ticket#9)
3119   + (Mac version): Fix build issue due to Mac OS X polluting the global
3120     namespace with its own "Point" class.
3122   + (Unix version): The Gnome print dialog has its own preview window so
3123     suppress ours if using the Gnome one.
3125   + (Unix version): Link aven with -lGLU which SuSE Linux needs.
3127   + (Microsoft Windows version): Fix handling of a double-click on the survey
3128     tree when built with wxWidgets >= 2.8.11.
3130 * cavern: Report relevant file and line number for three warnings which didn't
3131   give them before.
3133 * (Unix and Mac versions): configure: Update the wx-config probing code -
3134   wxmac-config etc aren't present with newer wxWidgets versions so there's no
3135   point looking for them now.
3137 * (Mac version): buildmacosx.sh: This script builds a diskimage with Survex in
3138   for easy installation.  Update it to work with the latest Survex versions
3139   (use WX_CONFIG not WXCONFIG; use a Unicode build of wxWidgets; if building a
3140   private wxWidgets, use 2.8.11 not 2.7.0-1).
3142 * manual:
3144   + Correctly capitalise "GTK".
3146   + Note that on Linux we only regularly test builds with the GTK+ version
3147     (change taken from 1.0).
3149 * Fixed the cad3d man page, which was an empty file in 1.1.13.
3151 Changes in 1.1.13 (2010-06-16):
3153 * Say "wxWidgets" instead of "wxWindows" consistently.
3155 * img.c: Fix small memory leak (filename_opened member).
3157 * cad3d, aven: Fix export to SVG when a label contains a '%' character.
3159 * aven:
3161   + wxWidgets 2.6.0 or newer is now required.
3163   + A "Unicode" build of wxWidgets is now supported.  An "ANSI" build may still
3164     work but hasn't been tested recently (all packaged versions of wxWidgets
3165     seem to be Unicode now).
3167   + Fix potential uses of uninitialised variables which may have been causing
3168     occasional glitches when loading a file on start-up.
3170   + Improvements to the handling of the font used for plotting labels and other
3171     text on the survey pane:
3173     - Loading the font file is more efficient.
3175     - Character spacing is improved.
3177     - Default font is now anti-aliased.
3179   + "About" dialog:
3181     - Add "Copy" button to copy the system info to the clipboard for easier
3182       bug reporting.
3184     - List OpenGL extensions last, since there are usually lots of them with a
3185       modern gfx card.
3187     - Fix 100% CPU usage while the "About" dialog is open.
3189   + Processing .svx files:
3191     - Passing a .svx file on the command line now works better.
3193     - Put the survey data log window in a splitter in the usual frame rather
3194       than opening a separate frame for it.
3196     - Auto-scroll the log window until we've reported a warning or error.
3198     - Fix small memory leak.
3200   + The presentation filename now defaults to using the basename of the
3201     currently loaded dataset, but we always prompt before we first save with
3202     such a name.
3204   + Reduce memory usage when saving a screenshot.
3206   + Allow "Toggle Fullscreen" to work even if no survey is loaded now that we
3207     persist the window size (and maximised or fullscreen state) between
3208     invocations.
3210   + Fix reporting of OpenGL errors.
3212   + Fix glitches when tilting while looking East.
3214   + Added Portuguese and Slovak translations of wxWidgets messages.
3216 * Documentation:
3218   + Rationalise manual formats - replace PostScript with PDF and drop RTF.
3220   + Drop the "alternative manual formats" self-extracting zip file - people
3221     will generally just want one of the formats, so downloading several
3222     together isn't very useful.
3224   + 3dformat.htm: Update for v6 format (thanks to Mike McCombe).
3226   + GPL.htm: Replace HTML version of licence with a link to the version on
3227     the FSF website.
3229   + ChngeLog.htm: Stop generating an HTML version of the ChangeLog - it's too
3230     low level to be of interest to non-developers, and developers can look at
3231     the source code.
3233 * (Unix version): configure: New preferred name for specifying wx-config script
3234   is WX_CONFIG.  WXCONFIG still supported for compatibility.
3236 * (Linux version): Source RPM package dropped as you can just build an RPM
3237   package from the source tarball.
3239 * (Microsoft Windows version): The installer is now created with a newer
3240   version of InnoSetup, which gives a 10% smaller download.
3242 Changes in 1.1.12 (2007-02-07):
3244 * aven:
3246   + Remember the window size or maximised/fullscreen state between invocations.
3248   + Add options dialog to "Export" similar to the one for "Print".
3250   + The "number of pages required" in the print dialog now updates when you
3251     change what is to be shown (underground legs/surface legs/station
3252     names/crosses).
3254 Changes in 1.1.11 (2006-11-25):
3256 * Updated Czech, Spanish, and Slovak translations.
3258 * (MacOS X version): Assorted OS X specific tweaks and fixes.
3260 * aven:
3262   + Pick a smaller and clearer font for labels.
3264   + Fix character spacing.
3266   + Tweak display of bearing and elevation angles to look nicer with
3267     proportional fonts.
3269   + Use the title from the 3d (or plt, etc) file for the window title
3270     rather than the filename.
3272   + Show distances to 2 decimal places rather than the nearest integer.
3274   + Only consider underground legs when calculating the depth bands and
3275     depth colouring.
3277   + Add "Colour by Error".
3279   + Add entry for "white" in date and error keys.
3281   + When setting the view to a single point, don't change the scale.
3283   + If reloading the same file, don't change the view
3285   + Fix filetypes selector in open dialog.
3287   + Fix the charset we use for aven in certain cases.
3289   + Call msg_init before using msg_lang or it won't ever be set!
3291   + Pass wx the full language code to initialise the C library locale.
3293   + Fix bug in generating prefix tree view which could lead to a bogus
3294     leading dot on some survey names (bug probably introduced in 1.1.10).
3296   + "New Presentation" now ensures that the side panel is open
3298   + Fix updating of cached opengl lists when the view is reset to the
3299     default.
3301 * Ignore LANG if it starts with a digit to avoid problems with bogus value for
3302   LANG which AutoCAD installation seems to set on MS Windows.
3304 * (Unix version): configure: Allow SGMLTOOLS and DOCBOOK_TO_MAN to be
3305   specified.  Either/both can be set to ":".
3307 * dump3d: Report unknown (to dump3d) codes returned by img.
3309 * img library: Flag all stations as underground in the old "ASCII" .3d format.
3311 Changes in 1.1.10 (2006-07-14):
3313 * aven: Clicking on a survey name in the survey tree now highlights it in
3314   the map view.  Double-clicking zooms the view to show the clicked survey
3315   highlighted.  Clicking the root clears the highlighting and double-clicking
3316   the root restores the default view.  To expand/collapse a branch, click
3317   on the "[+]" or "[-]" icon to the left of the survey name.
3319 * aven: The measuring line can now measure to anywhere in plan or elevation
3320   view (not just to a station!)  In plan view the horizontal distance and
3321   bearing are shown, while in elevation view the vertical distance is shown.
3323 * aven: Moving the mouse over a station in the survey view now highlights
3324   that station in the survey tree (though it may not be visible if the
3325   survey(s) it is in aren't expanded).
3327 * aven: Clicking on a station to centre the view now moves the mouse pointer
3328   to the new location of the station (except on Mac OS X where this isn't
3329   allowed).
3331 * aven: Fix which presentation toolbar buttons are shown as depressed.
3333 * Fix infinite loop reading 3d files with LRUD data (bug introduced in 1.1.9).
3335 * vim files are now installed with the correct paths (bug introduced in 1.1.9).
3337 Changes in 1.1.9 (2006-07-04):
3339 * (Unix version): Install desktop files for aven and svxedit contributed to the
3340   Ubuntu package by Phil Bull, and corresponding pixmaps.
3342 * Fix img to filter out cross-sections which don't match the subsurvey (if
3343   specified).  The API now returns img_XSECT_END to mark the end of a
3344   passage rather than setting a flag on the last img_XSECT of the passage.
3346 * Enhance integration with the vim editor - this can now colour .err files, run
3347   cavern from vim and parse error output, and run aven from vim.  Tweak the
3348   existing vim mode for .svx files to fix a few minor bugs and add support for
3349   the new "*data passage" style.
3351 * aven: fix drawing of the "blob" end of the measuring line on graphics cards
3352   which can't draw large enough blobs for us.
3354 * aven: sort out confusion about what encoding everything is in which means
3355   that the distance measured by the measuring line actually gets displayed
3356   and also fixes problems with empty menu items in non-English locales in
3357   some cases.
3359 * aven: redraw grey background after a menu is closed over the aven window
3360   with no survey loaded.
3362 * aven: fix bug which caused printing to crash (introduced in 1.1.8).
3364 * aven: avoid crash on some machines when opening "About" dialog before having
3365   loaded a survey.
3367 * aven: Translate "Plan" and "Elevation" buttons in print view dialog.
3369 * (Unix version): aven: Fix character set handling of cavern output.
3371 * cavern: Report an error if a cross-section is specified for a station which
3372   doesn't exist.
3374 * Updated French and Italian translations.
3376 * (Unix version): aven: Fix "Can't open message file `en_US' using path
3377   `${prefix}/share/survex'" error.
3379 * Fix bug in 3d file reading on 64 bit platforms when used in STANDALONE mode
3380   (doesn't affect Survex itself, but other applications which use img.c should
3381   update their copy).
3383 * (Unix version): Add checks that wxWidgets is a non-unicode version (wx 2.6
3384   and later are caught by configure, whereas older wx versions are caught when
3385   trying to compile).
3387 Changes in 1.1.8 (2006.06.30):
3389 * Drop support for building with wxWidgets versions prior to 2.4.0
3390   (which was released on 2003-01-07).
3392 * aven: Printing through aven now uses settings from the "[aven]" section
3393   of print.ini, and support for hierarchical sections (using "like=")
3394   has been disabled.
3396 * aven: Change mouse actions to be compatible with those in Survex 1.0.
3397   The mousewheel now zooms in/out (it doesn't do anything in 1.0) and
3398   left drag is now smart about not rotating and zooming at the same
3399   time.
3401 * aven: Highlighting stations now happens as you type, and pressing
3402   "Enter" or clicking the "Find" button now pans and zooms to show the
3403   highlighted stations.
3405 * aven: Left-clicking away from a station now cancels measuring line.
3407 * aven: Setting view to North, South, East, or West is now animated like
3408   the tilt from plan to elevation.
3410 * aven: Fix presentation saving to also write "." for decimal points and
3411   presentation loading to accept either "." or ",".
3413 * (Unix version): aven: Add text for all toolbar items so that aven
3414   will work with the Gnome desktop preference for displaying toolbars as
3415   icons with text or just text (wxWidgets needs fixing first though).
3417 * (Unix version): aven: Remove the ability to detach the menu bar (yell
3418   if you actually used it and I'll restore it!)
3420 * aven: Add "all survey files" option to the "open file" dialog.
3422 * (MS Windows version): aven: Fix cursor keys to pan survey.
3424 * (MS Windows version): Built with wxWidgets 2.6.3 instead of 2.6.2.
3426 * (MS Windows version): Fix installer to work on Windows 2000 or XP if
3427   run by an unprivileged user.
3429 * (MS Windows version): Upgrade to the latest version of InnoSetup (the
3430   installer builder we use) and include new installer translations for
3431   UK English, Spanish, Brazilian Portuguese, Italian, Romanian, and Slovak.
3433 * (MS Windows version): aven: Include Catalan and Brazilian Portuguese
3434   translations of messages for wxWidgets (the GUI library we use).
3436 * aven: Disable "Highlight exported points" if there aren't any.
3438 * Updates to French translation from Michel Bovey.  Also updates to German,
3439   Italian, Catalan, Spanish, and Romanian translations.
3441 * (Unix version): test suite: fix smoke test to pass even without X running
3442   (it was meant to but the code had a bug).
3444 * aven: Check if OpenGL is available and exit cleanly with a helpful error
3445   if it isn't.
3447 * (Unix version): aven: Fix --help and --version to work without a working
3448   X display (provided it's built with wxWidgets 2.5.1 or newer).
3450 * aven: Automatically select the presentation tab of the notebook when the user
3451   selects "New Presentation" or "Open Presentation".
3453 * aven: Fix "Delete" in the presentation list to not get passed on (and so not
3454   reset to default view as well).
3456 * aven: Fix Ctrl+Insert in the presentation list not to segfault if the list is
3457   empty.
3459 * aven: Fix Cursor Up and Down in the presentation list to move the highlight
3460   up and down instead of being passed on and moving the survey.
3462 * aven: Improve SVG output compatibility.  Tested with Mozilla Firefox 1.5,
3463   Adobe's SVG browser plugin, Gimp 2.2.8, Gqview 2.0.0, Opera 8.5,
3464   Safari 2.0.3, and InkScape 0.42.
3466 * aven: Put a 5mm border around exported SVG files to allow for station markers
3467   and non-zero width lines.
3469 * aven: Fix crash when exporting as SVG or Sketch if labels or surface data
3470   was turned on.
3472 * aven: Actually close the file we're exporting which fixes problems with it
3473   not always being fully written.
3475 Changes in 1.1.7 (2005.10.18):
3477 * cavern: Add validity checking for dates in *date commands (with feature
3478   test in testsuite).  A date entered as just "year" or "year.month" now
3479   becomes a date range for the relevant period (previously it became a single
3480   date near the middle of that period).
3482 * extend: Fixed 2 uninitialised flags (should fix erratic behaviour on
3483   with MS Windows).
3485 * extend: Default output name for a file called input.3d is now input_extend.3d
3486   rather than just extend.3d (which was annoying if you wanted to extend
3487   several surveys in the same directory).
3489 * aven: OpenGL 2.0 always includes support for point sprites so rework
3490   our check for them to include that knowledge.
3492 * aven: Regenerate depth bar if user switches to/from metric units.
3494 * aven: Don't clear the "there" mark just because the mouse pointer has
3495   moved off a station.
3497 * aven: When processing a .svx file, put the resultant .3d file in the
3498   same directory (since that's where we then try to load it from).
3500 * aven: Fix labelling of date colouring on 32 bit platforms.
3502 * aven: If "colour by date" is on and we load a survey with no date info
3503   (or all surveyed on the same date) then set "colour by none".
3505 * aven: Make the error dialog modal and remove a signal handler once it
3506   has fired to prevent endless (or seemingly endless) cascades of error
3507   dialogs.
3509 * aven: Enforce a minimum object volume diameter of 1m to avoid problems
3510   if a survey file with only one station in is loaded.
3512 * aven: Fix problems with indicators disappearing when we're drawing
3513   blobs and/or crosses the slow (but always supported) way.  (Problem
3514   introduced in 1.1.6).
3516 * (Unix version): aven: Really stop setting extra toolbar margin when using
3517   GTK2.0.  The attempt to fix this in 1.1.3 failed because __WXGTK12__ is
3518   set for GTK+ 1.2 or *any later release* so is true for GTK+ 2.0 too!
3520 * (Unix version): aven: Add details of which of wxGTK, wxMotif, and wxX11
3521   we've been compiled with, and which GTK+/Motif version where appropriate.
3523 * (Unix version): Fixed build on Fedora Core 3.
3525 * documentation: Updates to 3d file format specification from Mike McCombe.
3527 Changes in 1.1.6 (2005.10.10):
3529 * (MS Windows version): Distribution is about a third smaller than 1.1.5
3530   (mostly because mingwm10.dll is no longer required).
3532 * aven: If aven is asked to load a .svx, .dat, or .mak file, run cavern on
3533   it, showing cavern's output in a window (with errors and warnings clickable
3534   to load the offending file into an editor), and then loading the resulting
3535   3d file.
3537 * aven: Added "Colour by Date" option.
3539 * aven: Disable "Colour by Depth" option if there's no elevation variation.
3541 * aven: Don't crash if trying to load a survey with no elevation variation.
3542   Instead turn off depth colouring.
3544 * aven: Export as HPGL added.
3546 * aven: Improved update of mouse coordinates and measuring line (thanks to
3547   Martin Green).
3549 * aven: Show the coordinates of either the mouse pointer or the nearest
3550   survey station to it (if there is one near enough).  Showing both was
3551   confusing and meant the status bar overflowed on smaller displays.
3553 * aven: When printing an extended elevation, don't show bearing and elevation.
3555 * aven: Don't lock "flat" surveys which aren't extended elevations - a
3556   flat survey with LRUD data isn't flat any more!
3558 * aven: When we have to draw blobs and crosses the slow way (because the
3559   graphics hardware doesn't support the fast way), draw them so that they
3560   should appear at the correct depth into the 3D scene instead of on top
3561   of everything else.
3563 * aven: Make "play presentation backwards" icon green to match the other
3564   presentation icons.
3566 * (MS Windows version): aven: Mouse clicks on the survey view now set the
3567   keyboard focus there.
3569 * (MS Windows version): aven: Fix first redraw of a newly loaded survey.
3571 * (MS Windows version): aven: Fix redrawing of measuring line.
3573 * cavern: Store dates for img_XSECT.
3575 * cavern: Fixed small one-off memory leak if you specify -o more than once.
3577 * (Unix version): Check environmental variable LC_MESSAGES when deciding what
3578   language to use for messages.
3580 * (MS Windows version): "Print" on a 3d file now prints through aven rather
3581   than the separate printer driver (Unix has done this for some time).
3583 * Removed old printer drivers.
3585 * img library: When creating a 3d file, ignore img_XSECT if we've been asked
3586   to write a file format version which doesn't support it.
3588 Changes in 1.1.5 (2005.09.20):
3590 * (MS Windows version): aven: Fixed crash on start-up (introduced in 1.1.4).
3592 * aven: Make blobs round like they are in Survex 1.0.
3594 * aven: If the graphics drivers don't support drawing blobs using OpenGL
3595   point markers, fall back to drawing filled circles.
3597 * aven: If the graphics drivers support it, draw crosses as texture mapped
3598   OpenGL point markers which is much faster.
3600 * aven: Cross size increased to match Survex 1.0.
3602 * aven: We must update which blobs are displayed if display of surface or
3603   underground legs is toggled.
3605 * cavern: Fix handling of a *solve followed by survey data, none of which is
3606   attached to the previous data.
3608 * cavern: Fixed "No survey data" error when a *solve is followed by another
3609   *solve (or the implicit solve at the end of processing) with no data between
3610   them.
3612 Changes in 1.1.4 (2005.09.19):
3614 * aven: Added Aven's icon to the "About" dialog.
3616 * aven: Use localised character for the decimal point (e.g. "," in most
3617   continental European countries).
3619 * aven: Previously the survey tree would get focus and then take keypresses
3620   (e.g. "P", "L", "Delete").  Now we pass most keypresses across so they
3621   operate on the cave, and transfer the input focus across when we do.
3623 * aven: Make pressing "Return" in the tree control expand/collapse a subtree.
3625 * aven: Speed up intialisation by delaying creation of OpenGL lists until
3626   they're needed.
3628 * aven: Added Mark Shinwell's bounding box with shadow of the survey.
3630 * aven: Disable the "Tubes" button/menu item when there's no LRUD data.
3632 * aven: Reworded "Restore Default Settings" as "Restore Default View".
3634 * (Unix version): aven: Set sensible default margins for printing and preserve
3635   any margin values the user specifies between runs (previously margins
3636   defaulted to 0 each time aven was run).
3638 * Documentation: Document *DATA PASSAGE in the manual.
3640 Changes in 1.1.3 (2005.09.07):
3642 * (Microsoft Windows version): Fixed build problems.
3644 * cavern: Allow OMIT character (-) for left/right/up/down.
3646 * aven: Remove an unnecessary menu separator.
3648 * aven: Fix "Find" and "Hide" toolbar buttons to work with GTK2.0.
3650 * aven: Make the tooltip for "Hide" show the number of found stations.
3652 * aven: If * or ? is used in a glob-style pattern, force a non-substring match.
3654 * aven: Enable "New Presentation" when there's a 3d file loaded, rather than
3655   when there's a presentation loaded.
3657 * aven: Make entrances green in side panel tree list to match green blobs used
3658   in cave view.
3660 * aven: Don't show surface labels if we're not showing surface data, etc.
3662 * aven: Merge "Start Rotation" and "Stop Rotation" into "Toggle Rotation" and
3663   make "Space" the key for this.  Keep Return working "Stop Rotation" so
3664   existing users are happy, but don't advertise it.
3666 * aven: Normalise filename by adding any extension used, and use the normalised
3667   filename for file history and window title.
3669 * (Unix version): aven: Stop setting extra toolbar margin when using GTK2.0
3670   as the toolbar buttons already have a sensible margin - the extra margin is
3671   only needed with GTK1.2.
3673 * aven: Fix handling of plumb legs in tube model.
3675 * aven: Fixed swapped L and R in tube model.
3677 * extend: Preserve UD cross-section information in extended elevation.
3679 * extend: Add new messages for John Pybus' enhancements.
3681 Changes in 1.1.2 (never formally released):
3683 * Added support for LRUD data in .svx files, in .3d files, and aven can
3684   now load and display it on screen and on printouts.  The ability to "fake"
3685   LRUD data in aven is gone for now but will reappear in some form later.
3687 * cavern: Removed support for writing Chasm's 3dx format.  We're going to
3688   fold any desirable missing chasm functionality into aven.
3690 * aven: Rearranged mouse actions as discussed on the mailing list.  Added
3691   cursors for each different mouse action to help the user learn what each
3692   does.  Also added cursors for the "compass" and "clino" as well as the
3693   scalebar to suggest to the user that they can be dragged to change the view.
3695 * (Unix version): aven: Don't segfault if LANG isn't a known language.
3697 * tests/smoketest.tst: If X windows is running, check that we can run aven
3698   with --help and --version.
3700 * tests/cavern.tst: Fixed cavern.tst to warn if it is skipping a test because
3701   no results are listed for it.  This revealed that there was a "newline" test
3702   which should have been called "badnewline", and was a broken testcase too!
3703   Fixed all these problems.
3705 * cavern: Applied Simeon Warner's patch for handling backcompass, backclino,
3706   and omitted forward compass/clino readings in Compass DAT files.  Added
3707   a feature test for this to the testsuite.
3709 * It no longer makes sense to have an option not to build aven or to build aven
3710   without OpenGL so remove old machinery for this from configure and the
3711   sources.
3713 * (Unix version): configure: Check if "-lXxf86vm" is needed.
3715 * configure: Better output for strcasecmp test.
3717 * aven: Fix crosses to work much better.  Not a total fix - their position
3718   in the Z buffer isn't correct and they're rather slow to plot.
3720 * aven: Don't regenerate the hittest grid every time the mouse moves while
3721   animating, which solves the mysterious pausing effect (thanks go to Martin
3722   Green for spotting this!)  Also clear all the status bar coordinates when
3723   animating.
3725 * aven: Sort out clashing menu shortcuts in some languages.
3727 * aven: Fixed compilation problem on x86_64
3729 * SPUD: Pruned out stuff which has been done or which is not actually relevant
3730   to this branch.
3732 * Merge various changes from 1.0 branch:
3734   + aven: Port over "printing from aven" functionality.
3736   + aven: Port over "export as" functionality,
3738   + Add David Loeffler's vim mode for .svx files.
3740 * aven: Fix check for whether a label is behind us in perspective view.
3742 * aven: Don't use an opengl list for drawing the indicators - we typically make
3743   a new list each time we plot them anyway.
3745 * Remove lingering traces of support for RISC OS and pre-386 MSDOS
3747 * aven: Set icon on non-Windows platforms too.  This means that with
3748   WindowMaker on Unix you get an icon on the AppIcon by default.
3750 * configure: Update wxWindows checks to handle newer wx versions.
3752 * Make all maintainer perl scripts "use bytes;" to avoid utf-8 double encoding
3753   problems.  They also all require Perl 5.8 now (hopefully this isn't an issue
3754   for anyone building from CVS).
3756 * acinclude.m4: Quote macro name for fix autotools warning.
3758 * Documentation: "tilt up" is "'" not ",".
3760 * aven: Add support for mousewheels (to tilt the cave).
3762 * aven: Fixed twisted transitions to and from pitches in certain cases.
3764 * aven: Pick a sensible initial window size when the user's desktop is spread
3765   over more than one monitor (works best with wx2.5 or newer, but try to do
3766   better with wx2.4 or earlier as well).
3768 * aven: Initialise GfxCore slightly later to avoid visual glitch from notebook
3769   contents being visible before any survey is loaded.
3771 * aven: Allow a coloured texture to be used
3773 * aven: Don't initialise until we have data (to the user, this means the window
3774   is default colour (grey for most systems) not black until a survey is
3775   loaded).
3777 * aven: Fixed weird "shadowed" icons.
3779 Changes in 1.1.1 (2004-10-06):
3781 * (Microsoft Windows version): aven: Hopefully fix loading a survey file at
3782   startup.
3784 * aven: Delay loading the bitmap for the "About" dialog until it is first
3785   needed.  We want start up to be as quick as possible.
3787 Changes between 1.0.32 and 1.1.0 (never formally released):
3789 * NOTE: Survex 1.1.X releases are development snapshots made available for
3790   the purposes of allowing wider testing and getting more user feedback.  Once
3791   the code has stabilised the version number will be raised to 1.2.0.
3793 * aven: Now uses OpenGL for 3d rendering - you may need to install drivers if
3794   you're using Windows 95 - these can be obtained from:
3795   http://download.microsoft.com/download/win95upg/info/1/W95/EN-US/Opengl95.exe
3797 * aven: Solid passages - passage dimensions are currently inferred from
3798   the leg length (pretty effective as you can measure longer legs in
3799   larger passages).  Use of real LRUD data coming soon...
3801 * aven: Depth colouring is now continuously varying.
3803 * aven: Colour by depth can now be turned off (and there's the start of a
3804   framework for properly implementing colour by date, error, etc).
3806 * aven: Find stations moved onto the toolbar and now uses a simple wildcarded
3807   match (? matches any character, * matches any number of characters).
3809 * aven: We now use the status bar for coordinates, distances, etc to make
3810   better use of screen space.
3812 * aven: Full screen mode (F11).
3814 * aven: Perspective view.
3816 * aven: Context sensitive cursor shape - needs more work.
3818 * aven: Mouse actions changed (hopefully they're now more natural, but
3819   you may find the change disorientating - feedback wanted on this).
3821 * aven: Added "presentations" which allow you to set up fly-through paths
3822   and load/save/run them.
3824 * aven: A presentation can be exported as a movie file.
3826 * aven: Added Save screenshot facility.
3828 * aven: Depth fogging option.
3830 * aven: Added Smooth Lines option.
3832 * aven: Added Textured Walls option.
3834 * aven: If a survey has surface legs but no underground legs, default to
3835   showing the surface legs.
3837 * cavern: Dates given to *date are now stored in the 3d file.