source: git/NEWS @ c0c0cb2

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

Update for 1.4.3

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