source: git/NEWS @ 1934ef6

debug-cidebug-ci-sanitisersfaster-cavernloglog-selectstereo-2025walls-datawalls-data-hanging-as-warningwarn-only-for-hanging-survey
Last change on this file since 1934ef6 was 812a8d7, checked in by Olly Betts <olly@…>, 3 years ago

Note Microsoft Vista requirement

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