source: git/NEWS @ 73c0981

main
Last change on this file since 73c0981 was 398244d, checked in by Olly Betts <olly@…>, 4 days ago

NEWS: Update draft entry

  • Property mode set to 100644
File size: 204.4 KB
Line 
1up to: 84a61242e8ac204cd3cad21fcc4b65733d21b46a
2
3Changes in 1.4.21 (2026-0?-??):
4
5* cavern:
6
7  + Fix missing reports of unconnected survey stations.  We aim to report at
8    least one station in every unconnected piece of survey.  1.4.10 added code
9    to handle when a piece had been simplified to only anonymous stations, but
10    this was buggy and was only checking the first entry in the removed
11    traverse list.  We now check the full list, and if we somehow fail to find
12    an neighbouring named station, we report the anonymous station (we give the
13    filename and line number which is enough context by itself).  Reported by
14    Paweł Gogolak.
15
16  + `*entrance` now also suppresses unused fixed point warnings when it appears
17    before the `*fix` (previously this only worked for `*entrance` after
18    `*fix`).
19
20  + `*fix` with SDs now sets the "fixed" flag on the station in the .3d file.
21
22  + Pick better 3d file separator for Walls data (previously cavern would pick
23    `.` for the separator in a pure Walls dataset, even if it was used in
24    station names).  Walls uses `:` as a prefix separator, so now cavern takes
25    into account which characters are allowed in Walls station names when
26    picking the separator to use in the .3d file.  For a pure Walls dataset, it
27    will pick `:`, so Walls station names in the .3d file should match the
28    names as shown in Walls.  If a dataset mixes data in Walls format with
29    Survex and/or Compass data, then it's possible `:` is used in a Survex or
30    Compass station name and if so a different separator will be chosen.
31
32  + The Walls manual says to represent underwater data using the combination of
33    `TAPE=SS` with `ORDER=DA` or `ORDER=AD`, so we now map this to Survex's
34    diving style.  Issue highlighted by a dataset from Darek Lubomski.
35
36  + In Walls data, downgrade the "Unknown command" error to a warning for some
37    invalid directives which Walls quietly accepts.  Issue highlighted by a
38    dataset from Darek Lubomski.
39
40  + In Walls data, `#note` and `#flags` are meant to suppress unused fixed
41    point warnings, but only did if they came after the `#fix`.  Also `#flags`
42    without any flags didn't suppress the warning but now does.
43
44  + In Walls data, the word `fix` in `#flags` no longer sets the "fixed" flag
45    in the .3d file - we now only set it for stations used in `#fix`.  This
46    seems a more logical approach, since `#flags` is just free-form text which
47    Walls itself doesn't ascribe particular semantics to.  (The word `entrance`
48    in `#flags` still sets the "entrance" flag since Walls lacks a way to
49    explicitly mark entrances.)
50
51  + Check value after `TAPE=` in Walls data and give an error if it's not
52    valid.
53
54  + In Walls data, we now reject multi-component readings with a decimal point
55    in anything but the final component.  Some examples of invalid readings
56    which now give an error with cavern are `12.5i3`. `12.5:29`, `12.5:29:30`
57    and `12:29.5:30`.
58
59* aven/survexport:
60
61  + Allow exporting/not exporting anonymous stations.  The default is chosen as
62    most appropriate for each format.
63
64  + Fix memory leak in PLT export.
65
66  + Fix memory leak and speed up SVG export.
67
68* Documentation:
69
70  + Say "directive" instead of "command" in Walls docs since this is the
71    terminology Walls uses.
72
73  + Document Walls filename case mismatch issue.  Issue highlighted by a
74    dataset from Darek Lubomski.
75
76  + Document that the last official release of Walls uses an old IGRF version.
77
78  + Improve section on submitting documentation changes.
79
80  + Minor improvements to wording.
81
82  + HACKING.htm: autoconf 2.59 is the current minimum.
83
84* Test suite: Add test coverage for Walls compass/clino in mils.
85
86* Merge updates to Polish translation from Paweł Gogolak.
87
88* Merge updates to Russian translation from Vasily Vl. Suhachev.
89
90* (Linux version): survex.spec: We no longer provide this.  It doesn't work
91  with current Fedora because some dependencies have been renamed, which
92  suggests nobody is regularly using it, which isn't a surprise as there's
93  now a Fedora package of Survex.  Reported by Bill Gee.
94
95Changes in 1.4.20 (2026-03-04):
96
97* aven: The viewing volume now includes the vertical extent of terrain which
98  fixes problems with the terrain being clipped when there's an extreme
99  vertical difference between the terrain and the cave.  Hopefully fixes #148,
100  reported by Chris Curry.
101
102* aven: Improve handling of the scale when reloading an updated version of the
103  .3d file already being viewed.
104
105* aven: Add missing shortcuts to Orientation menu and "Reverse Direction" menu
106  item.  Reported by echarlie's friend.
107
108* aven: Where possible use L for "Elevation" menu accelerator, which matches
109  the shortcut key.
110
111* cavern: Improve handling of Walls percentage gradient.  Support explicit
112  percentage override ('p' suffix) and fix handling of overriding percentage
113  gradient to specify a plumb.  Reported by echarlie on #survex.
114
115* cavern: Support d:m:s for Walls bearings and gradients.  Reported by echarlie
116  on #survex.
117
118* cavern: Add `gps` as alias for `position` team role.  See:
119  https://github.com/therion/therion/issues/709
120
121* cavern: Warn for no blank after token in *cartesian (another case related to
122  #135).
123
124* manual: Document N, S, E and W shortcut keys for aven.
125
126* manual: Mark up codes and tokens in tables which avoids them getting
127  word-wrapped and hyphenated.  It also means they now get rendered in the
128  tables the same way they are referred to in the text.
129
130* manual: Separate each block of *instrument examples.
131
132* manual: Consistently document versions where features were deprecated.
133
134* Eliminate out-of-date postal address from licensing information.  Direct
135  people who somehow didn't receive the licence text to a copy on the FSF
136  website instead.
137
138Changes in 1.4.19 (2025-12-17):
139
140* aven/survexport: Rework PLT export to use 2 character escapes for spaces
141  and other characters which aren't valid in Compass station names.  We were
142  using 3 character escapes, but that's unhelpful since Compass has a 12
143  character station name limit.
144
145* cavern: The syntax of *instrument commands is now checked and a warning
146  issued for problems.  The information in the command is still not yet used.
147
148* cavern: Improve description of --quiet option.  Reported by Wookey.
149
150* (Microsoft Windows version): The installer now always updates DLLs it
151  installs rather than skipping DLLs which declare the same version number.
152  This avoids problems when DLLs change in an upwardly but not downwardly
153  compatible way but keep the same version number.  It also means downgrading
154  now gives an install more like installing the older version from scratch
155  would.  Our DLLs are all private and installed into our own install directory
156  so there are no concerns with breaking other installed software.  Fixes #145.
157  Reported by Footleg and Juan Corrin.
158
159* Fill in some missing Czech translations.
160
161* Update unofficial Inno Setup translations for the installer.
162
163* We now require at least FFmpeg >= 3.2 to build Survex.  This version was
164  released in 2016 so should be easily available everywhere now.
165
166* (Microsoft Windows version): Drop workaround for wx-config --rescomp not
167  working as this has now been fixed in the mingw package of wxWidgets.
168
169* Test suite:
170
171  + Add test coverage for `*data normal` without `clino`.
172
173Changes in 1.4.18 (2025-11-04):
174
175* aven: Fix "Enter" in search control to zoom to results.  This was broken
176  by the switch to wxSearchCtrl in 1.4.17.
177
178* aven: Fix "Find stations" search box width with wxWidgets >= 3.2.7.  Patch
179  https://github.com/ojwb/survex/pull/15 from Thomas Holder.
180
181* aven: (Microsoft Windows version): Fix sizing of indicators (scalebar,
182  compass, clino, colour key) on HiDPI monitors.  Fixes #144, reported by Juan
183  Corrin.
184
185* aven/survexport: Set UTM zone and datum in exported Compass PLT.
186
187* cavern: Avoid duplicate errors/warnings with unconnected data.  Since 1.4.10,
188  unconnected data is only a warning but that resulted in us running some
189  checks on the survey tree twice, which could result in duplicate
190  errors/warnings.
191
192* cavern: Fix parsing of hex digits in *set.  Hex digits a-f were incorrectly
193  being handled as 0-5, so 0x0a was byte 0 not byte 10.
194
195* cavern: We now track the column as well as file:line where a station or
196  survey name was used, so diagnostics which use these locations now report
197  a column number too.
198
199* cavern: Show context if proj can't convert coords.  We only do this for .svx
200  files currently as it is more complex for Compass and Walls data.
201
202* cavern: Fix reported column for error for `-` for Walls tape field.
203  In this context, Walls requires 2 or more `-` to indicate an omitted field.
204
205* cavern: Compass MAK file parsing improvements:
206
207  + Comments are now skipped.  Previously a commented-out MAK file command
208    would still be interpreted by cavern, which was incorrect.
209
210  + Whitespace handling has been adjusted to more closely match Compass.
211
212  + Unknown commands are now warned about.  Compass seems to quietly ignore
213    unknown commands, but it seems helpful for cavern to report them as it
214    will help identify any bugs in Survex's parsing of MAK files, and any
215    new or undocumented MAK file commands which we don't support.  It can also
216    help detect typos in data entry.
217
218  + We now skip to the closing `;` for unknown commands and commands we
219    ignore as not relevant to us, whereas previously we're just skip the
220    initial character which gives the type of command and then look for
221    another command.  This doesn't seem to make any difference in practice as
222    none of these commands appear to be able to contain text which could be
223    interpreted as a different valid Compass MAK file command.
224
225* (Microsoft Windows version): The toolchain we use to build this version
226  seems to have changed in an unhelpful way.  We've got the build working
227  again, but when aven is launched a black window opens first, then the
228  aven window opens over the top.  The black window stays around until
229  aven is closed.  This extra window doesn't really get in the way of using
230  aven, but it's not supposed to be there.  It doesn't seem to be due to a
231  change in the Survex code as the 1.2.17 build doesn't do this, but a
232  rebuild of 1.2.17 with just the minimum of build system changes does.
233  If you have suitable skills help fixing this would be much appreciated.
234
235* (Microsoft Windows version): Use unlocked file I/O if available, like we
236  already do for Unix.  Unlocked file I/O can be much faster in some cases (we
237  don't need the locking as we don't do multithreaded file I/O).
238
239* (Microsoft Windows version): Fix compiler warning in wrapaven.c.
240
241* (Microsoft Windows version): Work around wx-config --rescomp no longer
242  working.  The mingw package of wxWidgets has started to return an empty
243  string here.  We don't support building with MSVC, so hardcoding `windres`
244  here isn't really a problem in practice.
245
246* Manual: Document that *set eol default includes x1A (Ctrl-Z) to provide
247  compatibility with old DOS text files (it always has done but was missing
248  from the documentation).
249
250* Merge updates to Russian translation.
251
252* Add the start of a Czech translation.
253
254* Update unofficial Inno Setup translations for the installer.
255
256* Drop support for wxWidgets < 3.2.  It is starting to become hard to keep
257  everything working with 3.0.0 and the time and effort seems better directed
258  to other things.  The last 3.0.x release was 3.0.5.1, released 2020-05-02.
259  3.2.0 was released 2022-07-06 and it seems everywhere with wxWidgets packages
260  upgraded to 3.2.x some time ago.
261
262* Test suite:
263
264  + cavern.tst: Test more mixed line ending cases.
265
266  + Turn off tests involving aven and survexport on mingw, as we can no longer
267    seem to run these programs during the build.  Rebuilding the last commit
268    that worked now fails, so this is not due to a change in the Survex code.
269    There is no error message, but bash shows exit code 127 which means it
270    failed to run the command.
271
272  + Improve handling of VERBOSE in tests.  Previously VERBOSE showed output
273    from all testcases, even ones which passed.  Now we only show output from
274    testcases which fail for VERBOSE=1.  Other non-empty values of VERBOSE
275    continue to show all output for cavern.tst and smoke.tst, but have the same
276    effect as VERBOSE=1 for other tests.
277
278  + compare.tst: Fix to actually work, support --help, and allow comparing
279    cavern runs which fail.  This script is not run as part of the automated
280    tests but assists manually comparing two versions of cavern on the same
281    data which can be helpful for debugging and during development.
282
283Changes in 1.4.17 (2025-03-20):
284
285* aven: Add support for exaggerating Z.  You can now set a Z scale factor
286  from 0.1 to 10.0 via a new widget on the toolbar.  Fixes #49.
287
288* aven: The cavern log window now chooses foreground and background colours
289  based on the desktop's light mode/dark mode setting.  Previously it
290  used the default window background colour but always used black text, which
291  made it hard to read with a dark desktop theme.  (The wxWidgets API to detect
292  dark mode is new in 3.2, so if built with wxWidgets 3.0 then we assume
293  light mode.)
294
295* aven: The station search feature now uses the standard search
296  widget on GTK 3.6 or later and on macOS.  There's now a placeholder
297  text shown when there's no search to make it clearer what this
298  widget is for.
299
300* aven: There's currently a cavern bug where it can fail to identify all
301  traverses which are not involved in loop closure, which results in the .3d
302  file contains error information for them (unfortunately this seems tricky to
303  fully fix).  This error information is always zero, so as a workaround aven
304  attempts to detect these so that "colour by error" shows them as "not in
305  loop".  This workaround previously only checked for E being zero, but now
306  H and V are both also required to be zero.  This should help avoid some very
307  low error traverses being incorrectly treated as "not in loop", although in
308  practice I've not yet found a real world case where this actually makes a
309  difference.
310
311* aven: Fix the output encoding of `aven --help`, `--version`, etc.
312  Previously these were always encoded as UTF-8 which is usually right
313  on a modern system, but the terminal could be using a different
314  encoding.
315
316* aven: Reduce startup overhead a little when the terminal has a UTF-8
317  locale (which is now the default on most Linux distros).
318
319* cavern: Fix an "assertion failed" error in some situations when
320  equating to a fixed point.  This bug was introduced by changes
321  in 1.4.13.  Fixes #143, reported by Juan Corrin.
322
323* cavern: The syntax of *copyright commands is now checked and a warning
324  issued for problems.  The information in the command is still not yet used.
325
326* cavern: The syntax of *team commands is now checked and a warning
327  issued for problems.  The information in the command is still not yet used.
328
329* cavern: Stop reporting node stats.  These are kind of interesting, but
330  with the widespread use of Disto-X and similar devices which can easily
331  shoot multiple splay legs from each station means the number of larger order
332  nodes has increased and this information is now quite verbose and any utility
333  it had has substantially declined.  If these statistics are still wanted then
334  they could make a reappearance in the future in aven, with splays excluded
335  when counting the number of legs at each station.  Fixes #86, reported by
336  Wookey.
337
338* cavern: Fix wrong "unused fixed point" warning with *solve.
339
340* cavern: Fix double counting of stations which are referenced both before and
341  after *solve.
342
343* cavern: Suppress loop and component counts if *solve is used.  Our component
344  count was often wrong in this case but this looks very hard to fix.  These
345  counts are not vital so better to omit than report wrong values.
346
347* cavern: The "Equating two equal fixed points" warning now lists the
348  stations on the same order as they are in the `.svx` file which
349  seems clearer.
350
351* Speed up reading and writing of .3d files.  The time to read a large .3d file
352  and just count the stations and legs was more than halved by this change.
353
354* Simplify handling of errors loading the messages file.  The error
355  messages for this case are now stored as separate ASCII strings in
356  the executables which reduces the startup overhead a little as we
357  no longer need to scan them and potentially reencode them.
358
359* img library: The img struct's filename_opened member was always NULL when
360  used outside of Survex (and set but never actually used inside of Survex)
361  so it has been removed.  If you are referencing it in your code then instead
362  use the filename you passed to img_open_survey() when opening the file.
363
364* Documentation: Add details of warning about future dates in *date.
365
366* Documentation: Added new manual chapter on the img library.
367
368* Documentation: Improve comments document API in img.h.
369
370* Testsuite: Add proper test coverage for `*ref`.
371
372* Merge updates to Russian translation from Vasily Vl. Suhachev.
373
374* Portability: Eliminate unintended use of a C++17 feature (static_assert
375  with only one argument).
376
377* Portability: Avoid compiler warnings/errors in getopt code by properly
378  declaring getenv().
379
380Changes in 1.4.16 (2025-02-21):
381
382* aven: Improve "Colour by Survey".  Surveys whose names only differ in the
383  final character tended to get visually similar colours (often
384  indistinguishable), but now should get very different colours.  Reported by
385  Eric C. Landgraf and Patrick Warren.
386
387* aven: Add "Find" item to right-click menu on survey tree which triggers a
388  search for the survey or station that was right-clicked on which highlights
389  with a yellow blob on each station, like double-clicking used to before
390  1.2.36.  Requested by Patrick Warren.
391
392* cavern: Fix calculation of convergence which could incorrectly give zero
393  with some PROJ versions < 9.3.0.  Unclear exactly which versions are
394  affected, but seen with PROJ 8.2 and can't affect PROJ >= 9.3.0.  Reported by
395  Eric C. Landgraf.
396
397* cavern: Report approximate true grid convergence range which provides a way
398  to assess if the representative location(s) specified by `*declination auto`
399  are suitable.  Fixes #141, reported by Eric C. Landgraf
400
401* cavern: Support Compass 'C' shot flag.  In Compass this causes flagged legs
402  to not be subject to loop closure.  Survex now sets the SDs of such legs to
403  1mm, so flagged legs can still move slightly during loop closure.  Previously
404  Survex ignore this flag entirely.
405
406* Document Microsoft Windows version requirements.
407
408* Enable SSE2 by default on 32-bit x86.  Intel CPUs without SSE2 were
409  discontinued ~18 years ago so it seems very unlikely anyone is actually still
410  using one for Survex.  We keep hitting testcase failures due to excess
411  precision from 387 FP instructions, and the time spent adjusting testcases to
412  avoid these would be better spent on new features, etc.
413
414* Tighten up charset name parsing a little.
415
416* Merge updates to Russian translation from Vasily Vl. Suhachev.
417
418* Various minor improvements to documentation.
419
420* Various minor improvements to test coverage.
421
422Changes in 1.4.15 (2024-12-24):
423
424* aven: Avoid infinite redraw loop if GDAL gives an error loading geodata to
425  overlay.
426
427* aven: Turn off full-screen mode bodges when running on macOS 10.7 or later.
428  Fixes #110
429
430* aven/survexport: (Microsoft Windows version): Enable GDAL support so you
431  can now overlay geodata (in aven) and export shapefiles.
432
433* cavern: Remove now-bogus assertion which can fire when there's a survey not
434  connected to any fixed points (since 1.4.10 made unconnected data a warning
435  instead of an error).  Reported by Philip Balister.
436
437* (Microsoft Windows version): Strip debug data from .exe and .dll files which
438  reduces the installer size by around 5%.
439
440* Testsuite: Normalise -0.00 in DXF bounds too to avoid possible test failures
441  on x86.
442
443Changes in 1.4.14 (2024-12-11):
444
445* aven/survexport: Add support for exporting shapefiles.  This requires GDAL so
446  currently isn't enabled in the Microsoft Windows build.  Thanks to Eric C.
447  Landgraf for testing.  Fixes #87.
448
449* cavern: If *date with just year is followed by a blank, cavern expects a date
450  range and gives an error if another date doesn't follow.  Bug was introduced
451  in 1.4.13.
452
453* aven/cavern: Use ′ and ″ for feet and inches.
454
455* Documentation: Add some details on how to handle Toporobot "serie" station
456  naming.
457
458* Updates to Bulgarian, Hungarian, Russian and Slovak translations.
459
460* Testsuite: Adjust lollipop testcase to pass on i386 where excess precision
461  was changing which station was reported as the southernmost of multiple
462  candidate stations).
463
464Changes in 1.4.13 (2024-12-01):
465
466* aven:
467
468  + Don't show crosses on anonymous stations since they just clutter up the
469    display (especially for anonymous splays).  Suggested by Andrew Atkinson.
470
471  + Fix 1.4.10 regression in plotting of station names.  Each anonymous station
472    was blocking out a small rectangle which no actual station name could
473    overlap.  Reported by Špela Borko.
474
475  + Reduced start-up time by only initialising GDAL if we have overlays to
476    show.
477
478  + (Microsoft Windows version): Avoid recurring "GDAL support not enabled in
479    this build" message box.  This message is now only shown once if you try to
480    add an overlay.  Reported by Špela Borko.
481
482* cavern:
483
484  + Update to use v14 of the IGRF model for calculating declinations.
485    This was issued in November 2024 and should give slightly more accurate
486    declinations for surveys made since 2015.  Fixes #137.
487
488  + The component count was wrong in some cases, and we calculate the number
489    of loops using this component count, so the loop count would also be wrong
490    by the same amount in these cases.
491
492  + The component count and loop count are now reported when there are
493    unconnected survey stations.
494
495  + *date now supports ISO format dates.  Fixes #96, reported by Milosch.
496
497  + *date now supports date types "surveyed" and "explored" (existing usage
498    without an explicit type is interpreted as "surveyed").
499
500  + If the output directory isn't writable or doesn't exist we would complain
501    that we can't create the .err file - now we try to create the .3d file
502    first so complain about that instead which seems more helpful.  Reported by
503    Eric C. Landgraf.
504
505  + When inventing a fixed point we now avoid picking a fixed point which is
506    only attached to nosurvey legs if there's another option.  The code was
507    already meant to do this but it was buggy and we lacked a testcase for this
508    situation.
509
510  + Survey network reduction now finds some delta-star opportunities which were
511    being overlooked.  This allows more complicated networks to be reduced
512    further so fewer and/or smaller matrices need solving, which is faster.
513
514  + Survey network reduction now handles a "lollipop" with a fixed stick end
515    specially which is a little bit faster.  A more visible consequence is
516    fewer "Solving one equation..." messages when solving a complex survey
517    network.
518
519  + Survey network reduction now makes use of articulating legs to split up the
520    problem a little more, so we will often now solve more but smaller matrices
521    which should be faster.
522
523  + Assigning matrix row numbers now identifies equated stations in a slightly
524    more efficient way.
525
526* dump3d: Provide a way to get ISO format dates output.
527
528* Documentation:
529
530  + Improve documentation of *date in the manual.  When a partial date is
531    specified (just a year, or a year and month only) the documentation claimed
532    the centre of that year or month is used but actually this case is treated
533    as a date range covering the whole year or month (respectively).  The end
534    result is effectively the same as what was previously documented though
535    since the centre of a date range is used as the date for calculating
536    automatic declinations and is the date used by aven.
537
538* Test suite:
539
540  + Adjust hpglexport testcase to avoid i386 excess precision causing one of
541    the HPGL coordinates to differ by one from its value calculated without
542    excess precision.
543
544* Assorted translation updates.
545
546Changes in 1.4.12 (2024-10-23):
547
548* aven:
549
550  + (Microsoft Windows version): Geodata overlays are (hopefully temporarily)
551    no longer available in the pre-built version of Survex installed by the
552    Microsoft Windows installer.  We use the GDAL library to load them and
553    there's a hard to debug problem during DLL initialisation somewhere in its
554    dependency tree.  If you really need geodata overlays, the 1.4.9 installer
555    still works.  Thanks to Wookey for extensive testing to investigate the
556    problem, and to everyone else who reported this.
557
558* cavern:
559
560  + A leg with the same station as from and to is now only a warning in
561    Compass data.  Compass itself seems to quietly ignore such legs, but
562    they seem worth warning about.  In native Survex data this is still
563    an error.
564
565  + Short survey and station names are now stored without an extra memory
566    allocation.  On a 64-bit platform (most modern computers) we can store
567    name components up to 7 characters in this way; on a 32-bit platform
568    up to 3 characters.  On a large dataset which needs large matrices
569    solving this reduces cavern's memory usage by 3.5MB (~4.5%).  It's
570    also fractionally faster (but only ~0.05% which is not normally even
571    measurable).
572
573  + Assigning matrix row numbers to stations is now faster and allocates
574    less memory.
575
576* (Microsoft Windows version): The Microsoft Windows installer is now
577  named `survex-microsoft-windows-1.4.12.exe`.  The old name was
578  `survex-win32-1.4.11.exe` but the "win32" is now misleading as it's been a
579  64-bit build since 1.4.9.  Reported by Wookey.
580
581* Testsuite:
582
583  + dump3d.tst: Add tests of img library's survey filtering.
584
585  + cavern.tst: Normalise `-0.00` to `0.00` in JSON test output before
586    comparing with expected output.  We can get -0.00 on x86 due to excess
587    precision.
588
589* img library:
590
591  + Survey filtering now works correctly for files which use a survey level
592    separator other than `.`.  Patch https://github.com/ojwb/survex/pull/14
593    from Thomas Holder.
594
595  + Reading a v7 or earlier .3d format extended elevation with survey filtering
596    was failing to set is_extended_elevation.
597
598Changes in 1.4.11 (2024-08-14):
599
600* aven:
601
602  + Add imperial scales for export and printing.  Fixes #132, reported by Eric
603    C. Landgraf.
604
605* aven/survexport:
606
607  + HPGL export now uses pen 2 for splays and pen 3 for surface legs.  Partly
608    addresses #60.
609
610  + HPGL export now supports scaling (previous the scale was always
611    1:40000).
612
613  + KML export now distinguishes surface legs and splays using different
614    line styles.  Partly addresses #60.
615
616  + Remove Skencil export support.  The last release of Skencil was in 2005.
617    There was an attempt to revive the project in 2010, but that didn't lead to
618    another release and seems to have petered out.  No current Linux distro (or
619    other package system) seems to have Skencil packages, and the current git
620    version still appears to require Python 2 which is being phased out.
621
622* cavern:
623
624  + Support `*data ignore` to allow ignoring a block of survey data lines.
625    Closes #114, reported by Alastair Gott.
626
627  + Report error for bad final reading in `*data` command (previously such a
628    bad reading was quietly ignored).
629
630  + If the survey in `*end` doesn't match that in `*begin` the location of
631    that `*begin` is now reported as well - the second message here is new
632    for example:
633
634     badbegin.svx:6:8: error: Survey name doesn't match BEGIN
635      *end   bar
636             ^~~
637     badbegin.svx:4:13: info: Corresponding BEGIN was here
638      *begin      foo
639                  ^~~
640
641  + Now shows a context line for a reading which was on the previous line,
642    which can happen for interleaved data styles.
643
644  + Warn when a token is not followed by a blank, comment or end of line.
645    This is an unintentional tokenisation oddity which has been present
646    for a really long time.  We don't want to break files that rely on this
647    (even if they likely only do accidentally) so emit a warning rather than
648    an error.
649
650    This warning can easily be eliminated by adding a space where indicated,
651    which will work with old and new Survex versions.  Fixes #135.
652
653  + Errors and warnings which report an unexpected token now report a
654    contiguous span of letters and numbers rather than just letters in cases
655    where a number can't follow (which is the majority of cases).
656
657  + If `*require` isn't satisfied, the `*require` line is now shown for
658    context (especially helpful if there's a comment after the command noting
659    the reason for the requirement, as we now suggest in the manual).
660
661  + `*require` version parsing improved - spaces are no longer tolerated in
662    a version number and trailing junk after the version number is now
663    handled more consistently.
664
665  + Fixed several situations in which the highlighting of the context for a
666    diagnostic was off by a small number of columns.
667
668  + Optimise building of matrix during network solving.
669
670  + Enhancements and fixes to reading Walls WPJ and SRV files:
671
672    - After reporting an error for an unsupported datum, we now set the datum
673      to WGS84 to prevent triggering further errors from code which tries to
674      use the datum.
675
676    - Parse Walls WPJ commands as alphanumeric rather than alphabetic tokens,
677      which better matches how Walls parses them.  This only makes a difference
678      in the error message when we don't recognise a WPJ command.
679
680* Documentation:
681
682  + Note `feet` are international feet and how to select a different
683    definition in `*units` docs.
684
685  + Document `grads` are also known as "neugrads" and "gons" in `*units` docs.
686
687* Assorted translation updates.
688
689* testsuite:
690
691  + Fix bug in normalisation of `-0.00` to `0.00` in DXF output before
692    comparing with expected output.
693
694* Update and improve vim syntax highlighting:
695
696  + `*cartesian` added
697
698  + `*data ignore` added
699
700  + `mils` units now highlighted as deprecated
701
702  + `UP` and `DOWN` are no longer highlighted anywhere in a command
703
704  + `U`, `D`, `LEVEL`, `-V`, `+V`, `.`, `..` and `...` now highlighted in data
705    lines
706
707  + Repeated `NOT` in `*flags` is now highlighted as an error
708
709  + Fix error highlighting for unquoted `*include` to not flag an error just
710    because there's a comment after the filename
711
712  + Fix error highlighting for unquoted `*include` to work when there's
713    whitespace between `*` and `include`
714
715Changes in 1.4.10 (2024-08-05):
716
717* aven:
718
719  + Use a fixed rotation rate for rotating the view to North, South, East or
720    West (shortcut keys `N`, `S`, `E` and `W`).  We were using the same
721    variable rate which auto-rotation does for this case, but really these are
722    just animations to help the user see the change that's happening, so a
723    fixed rate makes more sense (and is what tilting to plan or elevation
724    does).  The new fixed rotation rate for this is double what the default
725    variable rate was, which means the longest rotation (e.g. from S to N)
726    takes 3 seconds rather than 6.
727
728* aven/survexport:
729
730  + Fix syntax of shot flags in PLT export (incorrect since introduced in
731    1.4.6).
732
733  + Map Survex duplicate flag to `L` shot flag in PLT export.
734
735  + Invent shorter names for anonymous stations in PLT export.  The PLT file
736    format documentation says station names can be up to 12 characters, but the
737    ones we generated were longer than this which is liable to trip up
738    consumers of this format that only allow for the specified length.
739    We now generate names using a sequential counter with a two character
740    prefix so they should fit in the 12 character limit for any cave
741    survey.
742
743  + 3D export now includes all leg and station flags.
744
745* cavern:
746
747  + Unconnected survey stations are now handled as a warning, whereas
748    previously this was an error.  This is necessary when processing Walls data
749    where it seems having hanging surveys is the norm, and Walls itself only
750    warns about them.
751
752    The support is also enabled for native Survex data since it allows viewing
753    the connected parts of a survey with missing connections without having to
754    comment out the unconnected parts (and then remember to fully uncomment
755    once connections are surveyed).  Fixes #16, reported by Duncan Collis.
756
757    Currently the component count and loop count are not shown in this case.
758
759  + Avoid multiple reports of an unconnected survey station.  This could happen
760    in some cases where a group of equated stations had more than four legs
761    connected to it.
762
763  + Fix missing report of unconnected survey station.  We aim to report at
764    least one station in every unconnected piece of survey, but if a piece had
765    been simplified to a single station which was anonymous (e.g. a disto splay
766    shot) then we wouldn't report anything for that piece.  Now we find the
767    traverse that was attached to it and report the next station along that
768    traverse.
769
770  + Report file and line location each unconnected survey station.
771
772  + This warning now says either `*entrance` or `*export` depending on which
773    it actually was:
774
775      Station "bar.1" referred to by *entrance or *export but never used
776
777  + Fix several cases of mishandling comments without blanks before them:
778
779    - After an anonymous station.
780
781    - After an ignored reading.  The `ignore` would incorrectly also skip the
782      comment character and any characters which followed up to the next blank
783      or end of line.
784
785    - In a `*alias` command.
786
787    - Diagnostic highlighting could continue into a comment.
788
789  + New `*cartesian` command which supports different orientations of
790    `cartesian` style data.
791
792  + Anonymous stations are now supported in `cartesian` style data.
793
794  + `*fix a reference` (without any coordinates) is now an error.  The
795    `reference` token provides a way to have a list of known fixed points which
796    are not expected to all be currently used, while omitting the coordinates
797    provides a way to specify a point to arbitrarily fix rather than rely on
798    cavern picking one.  Allowing both together doesn't really make sense.
799
800  + Improve check for 180° backclino to suppress the warning about a compass
801    reading on a plumbed leg (introduced in 1.4.8) to allow a small tolerance
802    on the value.  Previously the check wasn't working on x86 Linux for
803    example.
804
805  + When showing a line as the location of a diagnostic we now render any
806    tab character as a single space which means the `^~~~~` highlight length
807    is now correct even when the highlighted part contains tabs.  This only
808    affects use from a terminal as the highlight was already correctly handled
809    when viewing the log in aven.
810
811  + Enhancements and fixes to reading Walls WPJ and SRV files (thanks to Eric
812    C. Landgraf and Joe for a lot of great feedback from testing with large
813    datasets):
814
815    - The `RECT=` option is now fully supported.
816
817    - Fix `#DATE` with an active `.REF` to act like `DECL=`.  This matches what
818      the documentation says and what Walls seems to actually do.
819
820    - Allow completely omitting the clino on a wall shot (with `ORDER=DAV` or
821      `ORDER=ADV`).
822
823    - Resolve WPJ `.PATH` relative to innermost containing book.
824
825    - Handle an empty Walls station name.  Walls allows a station with an
826      explicit prefix to have an empty name, e.g. `PEP:`.  The Walls
827      documentation doesn't mention this, though it also doesn't explicitly say
828      the name can't be empty.  This quirk seems unlikely to be intentionally
829      used and Survex doesn't allow an empty station name, so we issue a
830      warning and use the name `empty name` (which has a space in, so can't
831      collide with a real Walls station name which can't contain a space) - so
832      `PEP:` in Walls becomes `PEP.empty name` in Survex.
833
834    - Flag stations with explicit Walls prefix as exported.
835
836    - Fix setting empty Walls macro with a comment right after it.
837
838    - Walls quietly ignores junk after the numeric argument in `TYPEAB=`,
839      `TYPEVB=`, `UV=`, `UVH=`, and `UVV=`.  This seems to be an undocumented
840      feature/bug so Survex emits a warning and skips the junk.
841
842    - After an unknown Walls option we now process the rest of the line.
843      Previously we were skipping the rest of the line.
844
845    - We no longer skip the rest of the line after a bad Walls `ORDER=` option.
846
847    - Correct the reported column for some Walls option diagnostics.
848
849    - Support explicit units on Walls clino readings.
850
851    - Allow `#` in Walls station names.  This is explicitly documented as not
852      allowed, but the documentation doesn't match the implementation and `#`
853      is present in some real-world data.
854
855    - Improve handling of Walls `RESTORE` error.  Highlight the position in the
856      line and don't skip the rest of the line.
857
858    - Don't warn about `INCH=` with a zero argument since that's the one case
859      of it we do handle!
860
861    - Fix not to skip the rest of the line after Walls `INCH=` option.
862      We currently don't support `INCH=` so we warn about it, but we were
863      skipping the rest of the line, then trying to read and discard the
864      argument to `INCH=` which gave an error.
865
866    - Relax handling of Walls `CASE=`.  It's not documented, but Walls32.exe
867      quietly treats unknown values as "Mixed".
868
869    - Support DM and DMS format for latitude and longitude in Walls `#FIX`,
870      e.g. `W97:43.875` and `W97:43:52.5` .
871
872    - Treat a zero length leg with finite variance like a Survex `*equate`.
873
874    - Apply Walls variance overrides to survey legs.
875
876    - The optional instrument and target heights are now parsed, but their
877      values are currently ignored.
878
879    - The delimiters around LRUD data are now parsed, but the LRUD data between
880      them is currently ignored.
881
882    - If a `#SEGMENT` value looks like a set of Compass shot flags (i.e.
883      consists only of upper case characters from `CLPSX`, optionally prefixed
884      with a `/` or `\`) then we interpret them as Compass shot flags (except
885      that `X` is mapped the same way as `L`).  This is apparently a common way
886      to use `#SEGMENT`, and unlikely to be triggered accidentally.
887
888    - Avoid a doubled directory separator when building Walls path names.
889
890* documentation:
891
892  + The manual has been converted from DocBook to reStructured Text.  The
893    plain-text format is much easier for making changes, and for users the
894    output from sphinx looks nicer and has extra features (like built-in
895    "Quick search" in the HTML output).
896
897    The plain text version of the manual is no longer generated.  Sphinx can
898    produce one but the .rst sources actually seem more readable for anyone
899    wanting to read the manual in plain text.
900
901    The extra targets to generate the manual in RTF and PostScript
902    have been dropped as I doubt they are still used (we stopped
903    providing them on the website years ago).  They could probably be
904    reinstated if there's a demand for them.
905
906    The conversion was partly automated followed by a full pass over the
907    result fixing issues with the automated conversion.  We took the
908    opportunity to also review the content and update or remove out of
909    date and other incorrect information, and to reorder some of the content.
910
911  + Document all the statistics in the `.err` file
912
913  + Document PLT export.
914
915  + Minor improvements to --help output
916
917  + The HTML version of the 1.4.9 manual was missing the Walls chapter
918    and had messed up paging links around it (due to the new CMAP chapter
919    accidentally also being given the filename `walls.htm`).  Reported by Eric
920    C. Landgraf.
921
922  + Document we don't enforce Walls' station or prefix length limits.
923
924  + Document handling of Walls `#NOTE`.
925
926  + Fix documentation of Walls `FLAG=` which is correctly handled, not skipped.
927
928  + Document how to compare Walls and Survex output via Shapefile.
929
930  + Document how to suppress unused fixed point warning in Walls SRV.
931
932* testsuite:
933
934  + Add testcase for Walls `#units order=da`.
935
936  + Add expected output for more testcases
937
938  + Add testcase for exporting .3d files.
939
940  + Normalise `-0.00` to `0.00` in DXF output before comparing to avoid bogus
941    test failures due to excess precision on x86 when using 387 FP
942    instructions.
943
944  + Add test of DXF export with full coordinates.
945
946* translations:
947
948  + Diagnostics can now use positional arguments which sometimes allows a
949    more natural word order in a translated message.
950
951Changes in 1.4.9 (2024-07-04):
952
953* aven:
954
955  + Support showing geodata overlays in Aven.  We use the GDAL library to load
956    the data, so this should work for any format which GDAL supports so long as
957    it can be read from the filing system and is geo-referenced vector data -
958    see https://gdal.org/drivers/vector/index.html for a list.  Currently the
959    dialog to select a file defaults to showing GPX, KML, GeoJSON and shape
960    files - set the filter to "All Files" to choose other formats.
961
962  + Reimplement display of cavern output.  The old version turned the log into
963    HTML and displayed it using wxHtmlWindow, but that adds a lot of overhead
964    and is especially inefficient if there are many diagnostics - cavern could
965    finish almost instantly yet aven could take many seconds to process the
966    output.  The new version renders directly from the log data.  It should
967    have most of the features from before - the only missing feature I'm
968    currently aware of is that you can't now select and copy text from the log
969    window, which wxHtmlWindow provided for free.  If people miss this feature,
970    we could add it to the new implementation.
971
972  + (Microsoft Windows version): Clicks in the cavern log window which load
973    files into an editor now protect the filename if it starts with a dash
974    to prevent it being interpreted as a command line option.  We already
975    do this for other platforms, but weren't on Microsoft Windows on the
976    assumption that it isn't needed because the filenames will be fully
977    qualified, but that may not be the case if aven if run by hand from the
978    command line or from some other launcher.
979
980* cavern:
981
982  + Add support for processing Walls format survey data (.SRV and .WPJ files).
983    This support is somewhat experimental but at a point where it seems useful
984    to make it easier for people to try out.  See the manual for a list of
985    known shortcomings.  Thanks to Eric C. Landgraf for a lot of testing and
986    encouragement.
987
988  + Fix bug with Compass DAT diving data.  If a survey uses the depth gauge
989    then since 1.4.6 we set its style to "diving", but we weren't clearing that
990    so all surveys after that in the same DAT file were also set as "diving".
991
992  + When parsing of Compass DAT files we report errors in more cases if the
993    input doesn't conform to the format we expect, rather than potentially
994    quietly misinterpreting the data.
995
996  + *entrance now suppresses "Unused fixed point" warning.  This warning is
997    intended to catch typos, which is much less likely for a station named
998    twice.  It's also reasonable to use only *fix and *entrance on a station at
999    the entrance of an unsurveyed cave.
1000
1001  + Highlight plumbed clino readings fully in diagnostics.  Now the full reading
1002    is highlighted instead of just the first character.
1003
1004  + Report location of previous fix after "already fixed" error/warning.
1005
1006  + Use "info" diagnostic category for "Originally entered here" message.  This
1007    is more logical as the original *begin isn't something to be warned about,
1008    only the reentering is.  This was only a warning before because we didn't
1009    used to have "info" diagnostics.
1010
1011  + Use "info" diagnostic category for message about not reporting further
1012    uses of a deprecated feature.  Previously this was a warning, but the newer
1013    "info" category is more appropriate here.
1014
1015  + The message about inventing a fixed point is now an "info" diagnostic which
1016    allows us to report a location which is where that station is defined,
1017    which may be useful to the user.
1018
1019  + Make highlighting position in error reporting more robust.  We no longer
1020    try to highIight if we calculate a negative column offset, when previously
1021    we would print billions of spaces.  As far as I know this has never
1022    happened in a released version.
1023
1024  + Error messages which report the program name now remove any ".exe" suffix.
1025    This helps the testsuite by making the expected output the same
1026    cross-platform, but also seems slightly nicer for users.
1027
1028* dump3d:
1029
1030  + The timestamp reported by DATE_NUMERIC is now printed portably.  Previously
1031    we were assuming that a time_t is the same size as a long int, which is not
1032    true on all platforms.
1033
1034* manual:
1035
1036  + (Microsoft Windows version): Update information about installation
1037    with/without admin rights.
1038
1039  + Summarise support for reading CMAP data and its assumptions and
1040    limitations.
1041
1042  + Mention Compass, Walls and CMAP support in the importing data howto
1043    section.
1044
1045  + Drop mention of Rosetta Stal from the manual.  The referred to link from
1046    our website was removed in 2015 because Rosetta Stal hadn't been updated
1047    for 13.5 years at that point.  Now the domain it was available from has
1048    lapsed and is a domain squatter "for sale" page.
1049
1050* img library:
1051
1052  + The coordinates in CMAP data are in feet but we were dividing rather
1053    than multiplying by the conversion factor to get metres so all
1054    coordinates were about 10.76 times too large.
1055
1056  + Stations in CMAP "station" variant XYZ files are now flagged as
1057    underground (as they always have been for "shot" variant XYZ files).
1058
1059  + When reading CMAP XYZ files, we no longer emit duplicate img_LABEL for
1060    stations in loops.
1061
1062  + A CMAP XYZ file without a survey title is now handled correctly (this was
1063    reporting a bogus "Out of memory" error).
1064
1065  + The img.h header now defines constants IMG_VERSION_SURVEX_POS, etc for the
1066    values reported in the version field for non-.3d formats.
1067
1068  + (Microsoft Windows version): Workaround limitation of Microsoft's C
1069    library so we handle dates before 1970 in Compass PLT files, CMAP XYZ
1070    files, and older format .3d files.  Previously these were reported
1071    as "unknown date".
1072
1073* We now support overriding the location of support files by setting the
1074  SURVEXLIB environment variable.  We no longer look at the srcdir
1075  environment variable for this.
1076
1077* (Microsoft Windows version): The installer is now created automatically
1078  on Github actions, which has required a few changes.  It now packages a
1079  64-bit build, and is created with Innosetup 6.3.2 which no longer supports
1080  Vista.  The installer is also now significantly larger, which is mostly
1081  because we now need to include a large number of DLLs, most of which are
1082  dependencies of the mingw64 FFmpeg and GDAL packages.
1083
1084* (Microsoft Windows version): If the directory where we expect the PROJ
1085  support files to be does not exist for some reason we now avoid triggering
1086  a segmentation fault in PROJ.
1087
1088* Build system:
1089
1090  + The GDAL library is now required to build Survex.
1091
1092  + (Microsoft Windows version): The probe for GL and GLU libraries now also
1093    checks for Microsoft's non-standard library names.
1094
1095  + Correct configure --help output for --enable-werror for which the default
1096    is actually "no" rather than "maintainer-mode".
1097
1098* testsuite:
1099
1100  + aven.tst: Skip a testcase when running on mingw as it seems to hang there.
1101    We already skip this testcase on macos for what appears to be the same
1102    problem.
1103
1104  + Fix comparison of output to work on platforms using DOS line endings.
1105
1106Changes in 1.4.8 (2024-04-23):
1107
1108* cavern:
1109
1110  + The warning for a compass reading on a plumbed leg was already suppressed
1111    for a compass or backcompass reading of 0, but is now also suppressed for a
1112    backcompass of 180° (or equivalent) which seems to be common in some Compass
1113    datasets, but also seems sensible generally.  Thanks to Simeon Warner for
1114    sharing some data which triggered such warnings.
1115
1116  + The error for when a survey and station use the same name is now also
1117    emitted in the case where a name was used first for a station, and then as
1118    a survey on an explicitly prefixed name.  Closes
1119    https://github.com/ojwb/survex/pull/4, reported by Thomas Holder.
1120
1121  + The error for when a survey and station use the same name now highlights
1122    the problematic name within the line shown for context.
1123
1124  + Fix the reported token string reported by some errors with readings.  This
1125    happened to work on at least x86-64 Linux, but the code was invalid and
1126    failed on some architectures.
1127
1128* Fix to build with newer FFmpeg versions.
1129
1130* (Microsoft Windows version): The installer now offers the choice to install
1131  for just the current user, which allows installing Survex without admin
1132  rights.
1133
1134* (Microsoft Windows version): Fix problems with valid coordinate systems being
1135  rejected and aven's cavern log window not showing output.  Reported by
1136  Peter Mašič, Špela Borko, Răzvan Dumbravă and detrito.  Thanks especially to
1137  Špela Borko for a lot of testing to help track down the cause.
1138
1139Changes in 1.4.7 (2024-04-07):
1140
1141* cavern:
1142
1143  + When using *declination auto we report the range of calculated declinations
1144    for each location specified.  After doing this we now reset the range
1145    information we're tracking.  Previously we'd misreport the range for
1146    the second and subsequent locations.
1147
1148  + Avoid undefined behaviour on handling filename fallback for filenames
1149    containing non-ASCII characters.
1150
1151  + Show context line with relevant item highlighted for more errors and
1152    warnings.
1153
1154  + The dynamic string handling routines are now more efficient.
1155
1156  + Fix memory leak if a Compass MAK file opens folders it doesn't close.
1157
1158  + Fix handling of clino-less legs in Compass DAT.  These would cause cavern
1159    to fail with a lot of "NaN" messages.  Now they're treated as having a zero
1160    clino with a standard deviation based on the leg length, just like in .svx
1161    files.
1162
1163* img library:
1164
1165  + Compass PLT: Treat LRUD readings > 900 as omitted readings, which matches
1166    what Compass does.  Thanks to Larry Fish for clarifying this.
1167
1168  + Avoid undefined behaviour after realloc().  We were adjusting a pointer
1169    within the reallocated block by subtracting the old block address and
1170    adding on the new one.  Technically this is undefined behaviour, although
1171    in practice it seems likely it'll work and we've not seen misbehaviour due
1172    to it.  However it's easy to avoid by calculating the offset before the
1173    realloc().
1174
1175* Portability:
1176
1177  + Provide prototype for getopt() to avoid warnings with very recent compiler
1178    versions.
1179
1180  + Avoid using sprintf(), which now triggers warnings on some platforms.
1181
1182* Build system:
1183
1184  + Add configure --enable-werror option to turn compiler warnings into errors.
1185
1186* Manual:
1187
1188  + Expand details of Compass MAK CRS support.
1189
1190  + Replace very out of date information about binary RPM packages.
1191
1192* Minor translation updates.
1193
1194* (Microsoft Windows version): Now uses PROJ 9.3.0 and ships all of the
1195  ancillary files that PROJ comes with.  Hoping this fixes use of coordinate
1196  system EPSG:3912 failing, which was reported by Peter Mašič but I've not
1197  managed to reproduce.
1198
1199Changes in 1.4.6 (2024-03-07):
1200
1201* cavern:
1202
1203  + Workaround bug in PROJ < 9.3.0 with projected coordinate systems with
1204    northing/easting axis order (such as EPSG:3042) which results in the grid
1205    convergence being wrong by about 90°.  Reported by Patrick Warren on the
1206    mailing list.
1207
1208  + If *declination auto was used before *cs out we would incorrectly calculate
1209    the grid convergence as 0.  We now handle this case correctly by
1210    calculating lazily when we first read a compass reading, and report an
1211    error if the output coordinate system hasn't been set by then.
1212
1213  + When opening a file, cavern has fallback handling if the file isn't found
1214    to help people processing datasets from platforms with case-insensitive
1215    file systems.  Previously cavern would fold the filename to lowercase and
1216    retry.  Now if this fails, it will also try the lower case version but
1217    with the initial character of the leaf in upper case, and finally folding
1218    the whole specified filename to upper case.
1219
1220  + Dynamically pick a suitable level separator character and store it in .3d
1221    file, instead of it being hard-coded to '.' (we still use '.' unless it
1222    has been *set as a "name" character, or for Compass DAT/MAK files unless it
1223    has been used in a station name).  This is a step towards addressing the
1224    situations raised by Thomas Holder in https://github.com/ojwb/survex/pull/4
1225    and https://github.com/ojwb/survex/pull/5 .
1226
1227  + Compass DAT files:
1228
1229    - The shot flag S is now understood to indicate a splay.
1230
1231    - The shot flag P is now interpreted as marking surface data.  This flag
1232      is described as "Exclude this shot from plotting", but the use suggested
1233      in the Compass docs is for surface data, and legs flagged with it "[do]
1234      not support passage modeling".  Even if it's actually being used for a
1235      different purpose, Survex programs don't show surface legs by default so
1236      the end effect is at least to not plot as intended.
1237
1238    - Surveys which indicate a depth gauge was used for azimuth readings are
1239      now marked as STYLE_DIVING in the 3d file.
1240
1241    - Compass and clino corrections are now implemented for backsights.
1242
1243    - The tape correction in Compass DAT files is now handled correctly.  The
1244      specified value is in feet, but cavern was incorrectly treating it as
1245      being in metres.
1246
1247    - We now handle the newer 15 character "FORMAT:" encoding.  Previously
1248      cavern wouldn't detect when there were backsights in this case.
1249
1250    - We now treat survey date January 1st 1901 as "no date specified" since
1251      this is the date Compass stores in this situation, and it seems very
1252      unlikely to occur in real data.
1253
1254    - In Compass DAT files a dummy zero-length leg from a station to itself is
1255      used to provide a place to specify LRUD for the start or end of a
1256      traverse (depending if dimensions are measured at the from or to
1257      station), and so we no longer issue a warning about equating a station to
1258      itself for DAT files.
1259
1260  + Compass MAK files:
1261
1262    - The base location command is now understood.  This is how Compass
1263      specifies a location to calculate magnetic declination at, and we
1264      now handle this like Survex's native "*declination auto X Y Z".
1265
1266    - Survex uses the specified UTM zone and datum provided the combination can
1267      be expressed as an EPSG code (lack of any EPSG codes for a datum suggests
1268      it's obsolete; lack of a code for a particular datum+zone combination
1269      suggests the zone is outside of the defined area of use of the datum).
1270      Example Compass files we've seen use "North American 1927" outside of
1271      where it's defined for use, presumably because some users fail to change
1272      the datum from Compass' default.  To enable reading such files we return
1273      a PROJ4 string of the form "+proj=utm ..." for "North American 1927" and
1274      "North American 1983" for UTM zones which don't have an EPSG code.
1275      Please let us know if support for additional cases which aren't currently
1276      supported would be useful to you.
1277
1278    - Folder commands are now understood.
1279
1280    - Flag fixed stations as entrances.  Experimentation with Compass shows
1281      this is how it treats them ("distance from entrance" in a .DAT file
1282      counts from 0 at these points).
1283
1284  + We now support reading Compass CLP files.  These are very like DAT files,
1285    except they contain loop-closed data.  You might find this useful if you
1286    want to keep existing stations at the same adjusted positions Compass gave
1287    (for example to be able to draw extensions on an existing drawn-up survey),
1288    or if the original DAT file has been lost but you still have the CLP file.
1289
1290* aven:
1291
1292  + Fix OpenGL scaling on high DPI displays with wxWidgets 3.0. Reported by
1293    Philip Balister.
1294
1295  + Split the filters for DAT and MAK files in the File->Open drop down list.
1296    It seems more likely you'd want to see one type or the other, not both
1297    together.
1298
1299* aven/survexport:
1300
1301  + Fix survey filtering when reading Compass PLT files.
1302
1303  + .json,.kml: Enable export of surface legs.  Currently surface and
1304    underground legs aren't differentiated in these export formats when both
1305    are enabled.
1306
1307  + .3d: The coordinate system is now set.
1308
1309  + .svg: Equated stations now get their correct names in the id attribute
1310    of <circle> tags.  Previously one of the names would be repeated for
1311    all of a set of equated stations.
1312
1313  + .plt:
1314
1315    - Anonymous stations previously resulted in an empty name in the PLT
1316      file.  This isn't explicitly disallowed by the PLT format description,
1317      but Compass' viewer gives an error for such lines.  Now we invent names
1318      by encoding the station coordinates which should be unique.
1319
1320    - The S shot flag is now set for splays, and the P shot flag (hide from
1321      plotting) is set for surface legs (which matches the use suggested in the
1322      Compass docs).
1323
1324* img library:
1325
1326  + Fix bug handling timestamps before 1970.  In C signed integer division
1327    rounds towards zero, which previously resulted in timestamps before 1970
1328    getting rounded to the end of the day instead of the start when converting
1329    them to a count of days so they'd be off by one day unless the time was
1330    midnight.  This affected reading v3-v7 format 3d files with IMG_API_VERSION
1331    set to 1 and writing v8 format 3d files with IMG_API_VERSION set to 0 (the
1332    default).
1333
1334  + Improve Compass PLT support (many of these are Compass features added
1335    since Survex's support for Compass was originally added):
1336
1337    - Survey dates are now handled fully.  We treat survey date January 1st
1338      1901 as "no date specified" since this is the date Compass stores in this
1339      situation, and it seems very unlikely to occur in real data.
1340
1341    - LRUD data is now translated to img_XSECT and img_XSECT_END.
1342
1343    - We now infer img_SFLAG_ENTRANCE for stations where the "Distance From
1344      Entrance" field is present and zero.
1345
1346    - The shot flag L is now translated to img_FLAG_DUPLICATE.
1347
1348    - The shot flag S is now translated to img_FLAG_SPLAY.  A station at the
1349      far end of a shot flagged S gets img_SFLAG_WALL set since the Compass PLT
1350      format specification says:
1351
1352          The shot is a "splay" shot, which is a shot from a station to the
1353          wall to define the passage shape.
1354
1355    - The shot flag P is now interpreted as marking surface data.  This flag
1356      is described as "Exclude this shot from plotting", but the use suggested
1357      in the Compass docs is for surface data, and legs flagged with it "[do]
1358      not support passage modeling".  Even if it's actually being used for a
1359      different purpose, Survex programs don't show surface legs by default so
1360      the end effect is at least to not plot as intended.
1361
1362    - The d plot command is now supported (previously img failed to parse
1363      PLT files using this command) - it's like D but implies the P shot flag.
1364
1365    - If a PLT file only uses one datum and it is "WGS 1984" then the UTM zone
1366      is converted to the appropriate EPSG code and this is reported as the
1367      coordinate system.  Other datums could be handled, but the mapping to
1368      EPSG code is less simple.  Also it seems Compass supports at least
1369      24 datums but it doesn't document all the strings it uses for them.
1370      Files with multiple datums could be handled too, but we'd need to convert
1371      coordinates to a common coordinate system in the img library, which would
1372      need it to depend on PROJ.  Please let us know if support for more and/or
1373      mixed datums would be useful to you.
1374
1375    - Duplicate img_LABEL items are no longer returned - this used to happen
1376      for stations where more than two shots met within a single survey.
1377
1378    - We now infer img_SFLAG_EXPORTED for any station that appears in more
1379      than one survey in the PLT file.
1380
1381    - We now set flag img_SFLAG_FIXED for any station which is listed as
1382      a fixed point in the PLT file.
1383
1384    - If there's only one non-empty section name in a PLT file and we aren't
1385      filtering by survey, we now report that section name as the title.  If
1386      there are multiple different non-empty section names, we still report the
1387      basename of the file as before.  If we're filtering by survey, we report
1388      the comment for that survey as before.
1389
1390    - Fix bug handling PLT with omitted LRUD.  The format specification
1391      documents that LRUD may be omitted, though it seems Compass never
1392      actually omits it and at least some versions of Compass failed to handle
1393      it being omitted too.
1394
1395* (Microsoft Windows version): Now using wxWidgets 3.2.4 (was 3.1.6).
1396
1397* manual:
1398
1399  + Document Compass support in detail.
1400
1401  + Improve NATO mils example.
1402
1403* INSTALL:
1404
1405  + Add a link to the instructions for building from git.  Reported by Andrew
1406    Northall in https://github.com/ojwb/survex/pull/13
1407
1408  + Document the requirement for a C99 compiler for building from source.
1409    We made this a requirement in 1.4.2, but only noted it in NEWS.
1410
1411* doc/TODO.htm: Update.
1412
1413* Replace references to "libav" with "FFmpeg" since the libav project seems to
1414  now be defunct, and we've always supported using either.
1415
1416* Update build system to eliminate use of obsolete autotools macros and drop
1417  probes for features that we can safely assume now we require a C99 compiler
1418  and workarounds for obsolete platforms.
1419
1420* Fix compilation warnings from newer compiler versions.
1421
1422Changes in 1.4.5 (2023-06-29):
1423
1424* aven: Fix rendering of crosses when drawn as sprites.  Reported by echarlie.
1425
1426* (macOS version): aven: Fix crash in export dialog.  Fixes #133, reported by
1427  rixyane.  Thanks to Wookey for testing.
1428
1429* manual: Expand docs on connecting to Compass data.
1430
1431* Minor translation updates.
1432
1433Changes in 1.4.4 (2023-02-03):
1434
1435* aven: Fix red line in clino background to be grey (this was introduced in
1436  1.4.3 and was a debugging change accidentally left in).
1437
1438* aven: Accept weird .3d files from Therion which have empty components in
1439  station names.  That's not really valid by Survex's definition of station
1440  names, but it's not very helpful to reject such files, so just disable the
1441  checks that were rejecting this.
1442
1443  The result is empty entries in the survey tree, but I don't see what we can
1444  really do that's better than that.
1445
1446  Reported by Vasily Vl. Suhachev.
1447
1448* aven: Make it more obvious you can enter a custom scale by adding a "..."
1449  entry to the scale combobox - selecting this clears the value and gives focus
1450  to the combo box text entry. This control has always supported clicking to
1451  enter a custom scale, but there wasn't really any indication that this was
1452  possible before.  Partly addresses #132, reported by Eric C. Landgraf.
1453
1454* aven: Force export window to resize when the export format is changed as
1455  different controls are shown depending on the export format.
1456
1457* aven: Right-align tilt spin control value in print/export dialog to match the
1458  bearing spin control.
1459
1460* aven,survexport: Add ability to export as Survex 3d which is useful as you
1461  can filter to a subset of surveys, filter out splays, convert from other
1462  formats the img library can read, etc.  This feature is a bit rough and ready
1463  currently but please report issues.
1464
1465* dump3d: Add --legs option which converts MOVE and LINE to a single LEG line
1466  per leg with the from and to coordinates.  Tools which parse dump3d output
1467  should find this easier to process as it avoids having to track a "current
1468  position".
1469
1470* Update manual to have a complete list of quantities which *calibrate accepts.
1471  Reported by echarlie
1472
1473* cavern.tst: Fix testsuite to work with SOURCE_DATE_EPOCH set.
1474
1475Changes in 1.4.3 (2022-05-17):
1476
1477* aven: Much improved support for HiDPI monitors on all platforms.
1478
1479* aven: When started without a file make sure the window has focus so menu
1480  accelerators and shortcuts work without clicking on the window.
1481
1482* aven,survexport: DXF export now puts splays in a separate layer and uses a
1483  dotted linetype for them.  Patch from echarlie, see #60.
1484
1485* Improved survexport man page to include command line options and a short
1486  note about DXF export.  Patch from echarlie.
1487
1488* Minor translation updates.
1489
1490* (Unix version): aven: Fix handling of EGL-based wxGLCanvas (which wxGTK 3.1.5
1491  has).  Fix a build failure and don't force X11 (as the EGL-based wxGLCanvas
1492  works on Wayland).
1493
1494* (MacOS version): aven: Fix hang on startup without a file.  Fixes #120,
1495  reported by Enrico Fratnik.
1496
1497* (Microsoft Windows version): Now using wxWidgets 3.1.6 (was 3.0.5).
1498
1499* img library: Support reproducible builds which create .3d files by not
1500  embedding a timestamp if environment variable SOURCE_DATE_EPOCH is set.
1501  Requested by Martin Budaj.
1502
1503Changes in 1.4.2 (2022-02-25):
1504
1505* aven: Fix to be compatible with FFmpeg 5.0.
1506
1507* Improve docs for *cs and *declination.
1508
1509* cavern: Fix "*declination auto" not to crash when built with PROJ < 8.1.0.
1510  Bug introduced in 1.4.0.
1511
1512* cavern: For each `*declination auto` command cavern now reports an "info"
1513  message showing the range of calculated declination values and the dates at
1514  which the ends of the range were obtained, and also the grid convergence
1515  (which doesn't vary with time).  Fixes #92, reported by Rob Eavis.
1516
1517* cavern: If any of the N-S, E-W or U-D ranges includes an anonymous station
1518  then also report the range in that direction excluding anonymous stations.
1519  Patch from Thomas Holder.
1520
1521* cavern: The error from a bad `*cs custom` command now highlights the quoted
1522  string properly.
1523
1524* cavern: "FIX command with no coordinates - fixing at (0,0,0)" is now an
1525  "info" rather than a "warning".  It's not really reporting a problem and the
1526  ability to omit the coordinates is a deliberate feature.  It is useful for
1527  the user to know where the "*fix" without coordinates is if they want to
1528  change the survey to be in real coordinates, so an "info" diagnostic is a
1529  good fit.  This also means aven will no longer stay on the log view after
1530  processing a dataset which fixes without coordinates.
1531
1532* cavern: If "*fix" is used twice with no coordinates we no longer say
1533  "FIX command with no coordinates - fixing at (0,0,0)" right before:
1534
1535  error: Already had FIX command with no coordinates for station "x"
1536
1537* cavern: Include errors in Compass .mak files now report the error in the line
1538  where the included filename is actually specified.
1539
1540* cavern.tst: Add test coverage for warnings for *entrance and *export with
1541  a station which doesn't exist otherwise.
1542
1543* aven/survexport: Change JSON export to be valid JSON.  This means the output
1544  has changed incompatibly, but it wasn't valid JSON before which suggests
1545  nobody was actually successfully using it. Fixes #128, reported by Pawczak.
1546
1547* aven.tst: Skip one testcase on macos as it seems to hang, at least when
1548  running on the Continuous Integration system.
1549
1550* (Microsoft Windows version): The installer is now generated with a much
1551  newer version of Innosetup.  This means Microsoft Windows Vista is now the
1552  minimum supported version but 2000 and XP are both many years out of support
1553  anyway.
1554
1555* (Microsoft Windows version): The coordinate system database for PROJ is
1556  now included so "*cs" now works (broken since 1.4.0).
1557
1558* Chinese translation updates from Qingqing Li.
1559
1560* Building from source now requires a compiler with support for C99.  C99
1561  seems to be universally supported by compilers now so we don't expect this to
1562  inconvenience anyone.
1563
1564Changes in 1.4.1 (2021-11-08):
1565
1566* This release should work with any PROJ version >= 6.2.0.
1567
1568* cavern.tst: Fix to actually run tests when building outside the source
1569  tree.  Previously files for testcases weren't found, and tests were skipped
1570  with a warning, which lead to 1.4.0 being released with two failing testcase.
1571  Fix to find the files, and make not finding them an error.
1572
1573* cavern.tst: Fix testcases gpxexport and require_fail which were failing
1574  in 1.4.0.
1575
1576* 3dformat.htm: Document that coordinate system can be ESRI:<number>.
1577
1578Changes in 1.4.0 (2021-11-06):
1579
1580* New release series to mark that Survex now uses the new PROJ API, and
1581  requires PROJ >= 7.2.0.  Survex 1.2.x will continue to support PROJ < 8
1582  (and won't support newer PROJ versions).  Fixes #102, reported by Bas
1583  Couwenberg.
1584
1585  Due to these changes, PROJ will now convert directly between coordinate
1586  systems where it knows how to, instead of always converting via WGS84.
1587  This means conversions may now be more accurate in some cases, and you may
1588  notice station coordinates changing - these should be for the better.
1589
1590  Also, the vertical datum is now taken into account automatically, and
1591  terrain data now aligns much better vertically with surveys.  Fixes #56.
1592
1593* aven: Clicking and holding the left mouse button on the compass or clino,
1594  then (while still holding) clicking the right button no longer causes a
1595  wxWidgets assertion to fail.  Reported by echarlie.
1596
1597* img library: Rewrite certain proj strings when reading 3d files for
1598  better compatibility with newer PROJ versions, where use of proj
1599  strings is strongly discouraged.
1600
1601  `+init=epsg:` followed by a code number is rewritten to `EPSG:`.
1602
1603  `+init=esri:` followed by a code number is rewritten to `ESRI:`.
1604
1605  The proj strings which cavern used to put in 3d files for UTM zones and
1606  S-MERC are rewritten to `EPSG:` follow by the appropriate code number.
1607
1608* Also install survex.lang for gtksourceview 4. Fixes #125, reported by Martin
1609  Green.
1610
1611* Fix missing data style in interleaved example in manual.  Reported by
1612  echarlie.
1613
1614* Use jw from docbook-utils instead of sgmltools-lite to process the manual.
1615  The sgmltools-lite homepage says it's no longer being developed, and suggests
1616  docbook-tools (which Debian packages as docbook-utils) as a replacement.
1617
1618* doc/HACKING.htm: Update Debian packages to install
1619
1620* doc/HACKING.htm: Update details of setting up mingw cross-build environment.
1621
1622* Add simple tests for GPX and KML export.
1623
1624* Expand cavern testcase csbad.
1625
1626* cavern.tst: Parse warning/error counts more robustly.  Previously we'd get
1627  confused if the final line just contained an integer, e.g. if we end listing
1628  stations not attached to a fixed point.
1629
1630Changes in 1.2.45 (2021-03-09):
1631
1632* Avoid undefined signed shifts in 3d file handling.  Survex itself is only
1633  affected on big-endian platforms (so most Linux machine, Microsoft Windows,
1634  and current Macs are all OK), but this also affects the img library on all
1635  platforms when used in standalone mode as it is in other programs.  Fixes
1636  #119, reported by Matěj Plch.
1637
1638* aven:
1639
1640  + When reading cavern output for the log window, we need special handling
1641    for the case when a chunk of output ends mid-way through a UTF-8
1642    sequence.  Previously we lost the first byte of the sequence in this
1643    case (and would then show it as an invalid character), but now it is
1644    handled correctly.  In practice, most of the cavern log output is ASCII so
1645    it's quite possible nobody's ever actually hit this.
1646
1647* testsuite:
1648
1649  + Suppress reports of leaks on exit from the LeakSanitiser debugging tool.
1650    We know we don't release all memory explicitly on exit since doing so would
1651    mean extra work for no reason as the OS reclaims all memory when the
1652    process exits.
1653
1654* Convert OLDNEWS encoding from ISO-8859-1 to UTF-8.
1655
1656Changes in 1.2.44 (2021-02-10):
1657
1658* aven:
1659
1660  + (Microsoft Windows version): Now using wxWidgets 3.0.5 (was 3.0.4).
1661
1662* cavern:
1663
1664  * Add support for quadrant bearings (e.g. N30E).  Patch from echarlie.
1665
1666  * Report error if angle units are specified for passage dimension.
1667    Previously "*units left degrees" and similar were incorrectly quietly
1668    accepted.  Spotted by echarlie.
1669
1670  * Fix *data with no parameters to keep the current style and reset any state
1671    as documented.  Previously it actually instead ignored any survey data
1672    until the next *data command with parameters.
1673
1674  * Fix minor memory leak in *data.  We leaked a single memory allocation on
1675    "*data default" or an invalid *data command.
1676
1677  * Improve test coverage.
1678
1679* survexport:
1680
1681  * The check for whether a format supported --elevation, --plan, --bearing and
1682    --tilt was inverted.  Reported by echarlie.
1683
1684  * Fix reporting of export errors on Microsoft Windows.  Reported by Matic Di
1685    Batista.
1686
1687* img library: Fix img_open() when used in other programs.  Patch from Thomas
1688  Holder.
1689
1690* configure: Add wx-config-gtk3 to WX_CONFIG search for Arch Linux.  Patch
1691  from Thomas Holder.
1692
1693* Improve documentation of interleaved data.  Most notably, we now document
1694  that a blank line breaks the current traverse.
1695
1696* Fix typo in manual ('cypolar' -> 'cylpolar').  Patch from Wookey, fixes #117.
1697
1698* Chinese translation updates from Qingqing Li.
1699
1700* Russian translation updates from Vasily Vl. Suhachev.
1701
1702* French translation updates from Jean-Marc and from Wassil Janssen.
1703
1704* Bulgarian translation updates from Wassil Janssen
1705
1706Changes in 1.2.43 (2020-02-28):
1707
1708* cavern: Update to use v13 of the IGRF model for calculating declinations.
1709  This was issued in December 2019 and should give slightly more accurate
1710  declinations for surveys made since 2010.
1711
1712* aven:
1713
1714  + Fix colouring of "not in loop" when colouring by error.  1.2.42 introduced
1715    a bug where surveys not in a loop were coloured as if they had zero error.
1716    Fixes #111, reported by Bruce Mutton.
1717
1718  + Fix handling of grid in export.  The grid was always getting enabled
1719    (probably since 1.2.8) even for formats which don't support exporting with
1720    a grid.  This resulted in the bounding box being set wrongly for some
1721    formats such as SVG, as reported by Richard Knapp on the mailing list.
1722
1723  + When showing errors processing the survey data we'd previously crash if
1724    cavern incorrectly reported an error as being in a column off the end of
1725    the line - now we just ignore the error column in this case.
1726
1727  + Support colouring by survey style ("normal", "diving", "nosurvey", etc).
1728
1729Changes in 1.2.42 (2019-09-04):
1730
1731* aven:
1732
1733  + Allow colouring by horizontal or vertical error.
1734
1735  + (Unix version): Disable scaling for HiDPI displays with GTK3.  The OpenGL
1736    code needs work before this will work usefully, so just disable for now
1737    (which simulates how things are when using GTK2).
1738
1739  + (Unix version): Fix orientation of notebook tabs when build with wxWidgets
1740    3.1 development versions.  We want horizontal tab orientation, but were
1741    passing a weird flag combination which now results in vertical tab
1742    orientation.
1743
1744* When exporting to a format where we support rotation in the horizontal
1745  plane (such as SVG), the rotation was incorrectly applied to cross section
1746  data (except for the default rotation of zero).  Fixes #108, reported by
1747  Richard Knapp.
1748
1749* Add a section to the manual covering the command line tools, and what you
1750  might still need to use them for.
1751
1752* Fix compiler warning when building from source with GCC 9.
1753
1754* Consistently refer to macOS not OS X - Apple have renamed it yet again.
1755
1756* (macOS version): Revert the workaround for the crash on macOS 10.14.  The
1757  bug we were working around is fixed in git ready for wxWidgets 3.0.5 and
1758  there's a backported fix in the homebrew wxmac 3.0.4-2 package, which is how
1759  we now recommend people install on a Mac.  Closes #101, reported by floho.
1760
1761* (macOS version): Remove buildmacosx.sh script since installing from homebrew
1762  is now the recommended approach.
1763
1764Changes in 1.2.41 (2019-07-10):
1765
1766* aven:
1767
1768  + (Microsoft Windows version): Fix error on startup in the pre-built version
1769    of 1.2.39 and 1.2.40.  This is a recurrence of the same issue as affected
1770    1.2.33 - this time I've patched out the unnecessary check in wxWidgets
1771    which causes this problem so it shouldn't recur again.  Reported by
1772    Brian Clipstone.
1773
1774  + (macOS version): Add work around for crash on macOS 10.14 (not fully tested
1775    as I don't have access to a Mac).  Hopefully fixed #101, reported by floho.
1776
1777Changes in 1.2.40 (2019-07-04):
1778
1779* aven: Draw the measuring line ring with an even shape.  Previously the exact
1780  shape of the ring varied slightly depending on the exact coordinates, which
1781  could be visually distracting once you noticed it.
1782
1783* We were casting a function pointer with a bool return type to the same type
1784  but with a void return type.  In practice this probably works fine on most
1785  platforms, but it's undefined behaviour and also gives a compiler warning
1786  with some compilers.
1787
1788* Fix bug introduce in 1.2.39 with where the "esri" data file for PROJ is
1789  installed.
1790
1791Changes in 1.2.39 (2019-06-29):
1792
1793* Support versions 5.x and 6.x of the PROJ library we use for handling
1794  conversions between coordinate systems.  Reported by Bas Couwenberg
1795  in #102, by Richard Knapp in #103 and by Martin Sluka in email.
1796
1797* (Unix and Mac OS versions): When checking if something is a file or if it is
1798  a directory, we no longer treat a symlink as being neither, but instead
1799  return an answer based on what the symlink points to.
1800
1801* aven:
1802
1803  + Improve handling of hidden splay ends.  Previously, hidden splay ends still
1804    served as "targets" for snapping the mouse pointer to, and still got
1805    crosses when crosses were enabled.  We don't have a handy flag for "this is
1806    the outer end of a splay" and computing that on demand isn't so easy to do,
1807    so for now we use the "anonymous station" flag so at least these cases now
1808    behave properly for splays to anonymous stations (which is likely to be
1809    what people with huge numbers of splays from disto-x, etc are using).  This
1810    does mean that anonymous stations on continuation passages will incorrectly
1811    also be off when splays are hidden, but that seems an OK trade-off for now
1812    and a definite improvement over the previous situation.  The snapping of
1813    the mouse pointer was reported by Frank Tully in #105.
1814
1815  + Fix typo in export UI (CVS should be CSV).
1816
1817* Documentation:
1818
1819  + Add CSV to documented list of survexport output formats.
1820
1821  + Fix *declination syntax synopsis - "auto" is a literal string, not a
1822    placeholder.
1823
1824  + Update PROJ project name and website - the name is now "PROJ" (all caps and
1825    no ".4" suffix) and the website is now: https://proj.org/
1826
1827* Install gtksourceview-3.0 language file so .svx files now get syntax
1828  highlighting in gedit and other GtkSourceView-based editors.  Patch
1829  from Philip Withnall.  Fixes #98.
1830
1831* (Microsoft Windows version): The Survex installer doesn't uninstall the old
1832  version when you upgrade, but just overwrites it with the new version.  In
1833  1.2.35 cad3d.exe was replaced with survexport.exe, but a user upgrading from
1834  an older version would still have cad3d.exe from that old version.  We now
1835  remove any old cad3d.exe left over from a previous install in the same
1836  location to avoid confusion.
1837
1838* Add a few more message translations.
1839
1840* Fix warnings when built with a C++11 compiler.
1841
1842Changes in 1.2.38 (2019-03-02):
1843
1844* cavern:
1845
1846  + Deprecate MILS as angular units.  Survex has long support MILS as an alias
1847    for GRADS.  However, this seems to be a bogus definition of a "mil" which
1848    is unique to Survex (except that Therion has since copied it) - there are
1849    several different definitions of a "mil" but they vary from 6000 to 6400 in
1850    a full circle, not 400.  Reported by Andy Edwards.
1851
1852  + Fix segfault for *include "".  This isn't useful, but shouldn't crash.  It
1853    now reports "file not found" instead.
1854
1855  + Use isnan() to check for not-a-number.  This is cleaner, more robust and
1856    more efficient than formatting the number as a string and checking for
1857    "NaN" or "nan" in the result.
1858
1859* Avoid unused variable warning when compiling from source with modern ffmpeg.
1860
1861* Drop support for wxWidgets < 3.0.  3.0.0 was released over 5 years ago and
1862  should be easily available everywhere by now.  I'm no longer easily able to
1863  test with wxWidgets 2.8, and this allows a significant amount of cruft to be
1864  removed.
1865
1866* (Linux version): survex.spec: Fedora have removed gcc from the default build
1867  environment so need to explicitly list it in the BuildRequires tag.  See
1868  https://fedoraproject.org/wiki/Changes/Remove_GCC_from_BuildRoot for more
1869  information.  Patch from James Begley.
1870
1871Changes in 1.2.37 (2018-11-18):
1872
1873* aven:
1874
1875  + Add basic "Colour by Survey" feature.  The colours used aren't currently
1876    controllable.
1877
1878  + Fix export of splays.  Patch from Thomas Holder.
1879
1880  + Fix KML export to avoid invalid geometry when a tube intersects itself.
1881    Patch from Robert Jones.
1882
1883  + (Unix version): Fix to work under Wayland by forcing the x11 GDK backend
1884    for now.  This is a workaround until wxWidgets OpenGL support is updated
1885    to work under Wayland.  Reported by Philip Balister.
1886
1887  + Fix warnings about using deprecated functions when building movie export
1888    code using FFmpeg 4.0.
1889
1890* cavern:
1891
1892  + Compass MAK files: Handle fixed point coordinates in feet - previously the
1893    units were ignored and the coordinates assumed to be in metres.
1894
1895  + Previously the first byte in a MAK file was ignored.  Typically MAK files
1896    start with a comment, and since cavern currently ignores lines that start
1897    with characters it doesn't understand the meaning of, this bug would often
1898    go unnoticed.
1899
1900* survexport:
1901
1902  + Fix exporting of passages, walls and cross-sections by running the code
1903    aven uses to decide how much to rotate each cross-section.  Previously all
1904    cross-sections were aligned West-East.  Reported by Robert Jones.
1905
1906  + Default to .pos output if the program name is 3dtopos, and install a second
1907    copy (or hardlink under Unix) as 3dtopos.  This provides compatibility with
1908    current releases of Tunnel.  Reported by Becka Lawson, Wookey and
1909    Stephen Crabtree.
1910
1911* Fix some German translations.  Patch from Thomas Holder.
1912
1913* (MacOS X version): Fix aven-create-app to not delete converted icons.
1914  Typo spotted by Robert Jones.
1915
1916* Improve documentation for *team.  Document the requirement to quote names
1917  unless a person is identified by just one name.  Document that the roles are
1918  optional, as that information may not have been recorded, and to align with
1919  therion's team command.
1920
1921Changes in 1.2.36 (2018-07-18):
1922
1923* aven:
1924
1925  + Add support for exporting as a CSV (Comma-Separated Values) file.
1926
1927  + Support exporting KML with altitude mode "clamp to ground".  In this mode,
1928    the altitude in the data is ignored and it's rendered on the surface of the
1929    terrain.  This is useful if your KML viewer renders the terrain as opaque
1930    so underground data isn't visible.  Rendering cave passages on the surface
1931    isn't great, but is better than not being able to see them at all.  This
1932    option may also be helpful if you want to see where to look on the surface
1933    for new entrances.
1934
1935  + Highlight surveys with a white loop as the mouse is moved over them in
1936    the survey tree.  This is akin to how we highlight a station with a
1937    white ring, and allows restoring "double-click survey in tree to zoom"
1938    which temporarily required a quadruple-click in 1.2.35.
1939
1940  + Only show checkboxes in the survey tree for surveys not stations.
1941
1942  + Fix wxWidgets assertion if the user tried to select additional surveys
1943    to show via the right-click menu.
1944
1945  + Fix multiple survey filtering when both a parent and child survey are
1946    selected.  In this case it makes most sense to show all child surveys of
1947    the parent, but we actually showed a slightly arbitrary subset of the
1948    child surveys of the parent.
1949
1950  + The checkbox area in the survey tree is now included in the area which
1951    is considered by mouse-over updates such as highlighting the station or
1952    survey.
1953
1954  + Fix display of double quotes in cavern log window (they were being replaced
1955    with control character 0x16 due to a typo in the code).
1956
1957  + Add shortcuts to buttons in cavern log window.
1958
1959  + Eliminate use of gluErrorString() function which eliminates some
1960    deprecation warnings when building on macOS.
1961
1962  + Reject multiple --survey command line options for now (only the last has
1963    been used for a long time, but now we actually support multiple survey
1964    filtering this matters more).
1965
1966* survexport:
1967
1968  + Report a useful error when trying to convert a .3d file without coordinate
1969    system information to GPS.  Reported by Mark Shinwell.
1970
1971  + Handle multiple redundant --survey command line options correctly.
1972
1973* dump3d: Report station flag "WALL", which was added in 1.2.7.
1974
1975* Minor translation updates.
1976
1977* Update manual for Microsoft Windows changes.
1978
1979* tests/: Add test coverage for warnings about suspect readings
1980
1981* Fix warning when compiling with clang.
1982
1983Changes in 1.2.35 (2018-07-03):
1984
1985* aven:
1986
1987  + Viewing can now be restricted to multiple surveys.  Use the right-button
1988    menu on a survey in the survey tree and select "Show" to enable checkboxes
1989    for that survey and all its siblings.  Only the selected surveys are shown
1990    on screen, printed and exported.
1991
1992  + Don't open a survey when its name is double clicked.  This was happening
1993    due to code added to "allow double-clicking to work on wxMSW >= 2.8.11".
1994    However, reverting that change still seems to allow double-clicking to work
1995    on both wxMSW and wxGTK, but fixes the unwanted additional opening of the
1996    survey.
1997
1998  + Pick initial survey scaling based on whichever of the window width or
1999    height gives the smaller scale.  Previously we always used the window
2000    width, which can result in parts of the cave being outside the initial
2001    view.  Reported by Wookey.
2002
2003  + Drop ability to specify a PROJ string in the export dialog.  This was added
2004    to allow exporting to formats such as GPX before we added support for
2005    specifying the projection in .svx files, and that support is now mature.
2006
2007  + DXF export now uses 2 decimal places (was 6) for the bounding box, for
2008    consistency with the precision used for coordinates.
2009
2010  + Fix handling of surface flag during export.  In formats which discriminate,
2011    legs could previously have got assigned the wrong status.
2012
2013  + Fix bug which probably prevented aven starting when OpenGL double buffering
2014    is unavailable.  This is unlikely to affect any common configurations.
2015
2016  + (Microsoft Windows version): Fix loading of 3d files with non-ASCII
2017    filenames.  Issue reported by Matic.
2018
2019  + (Microsoft Windows version): Fix incorrect display of some toolbar icons.
2020    Probably broken since 1.2.17.
2021
2022* survexport: New command-line export program which uses aven's export code.
2023  Replaces 3dtopos, cad3d and findentrances, since it can do all that these
2024  tools could do, plus much more.
2025
2026* Merge more Spanish i18n updates from Evaristo Quiroga.
2027
2028* Minor updates to various other translations.
2029
2030* img library:
2031
2032  + Now supports reading from and writing to an existing FILE*.
2033
2034  + Improve API documentation.
2035
2036* (Microsoft Windows version): Fix packaging to include wxWidgets translation
2037  files like it was supposed to, which fixes a few missing translations.  This
2038  was probably broken by changes in 1.2.8.  Reported by Evaristo Quiroga.
2039
2040* (Microsoft Windows version): Drop two options from explorer bindings.
2041  "Convert to DXF" and "Convert for hand plotting" have both been supported via
2042  aven for a while, and that's a more useful way to access them as you can
2043  control what gets exported.
2044
2045Changes in 1.2.34 (2018-03-24):
2046
2047* aven:
2048
2049  + (Microsoft Windows version): Fix error on startup in the pre-built version
2050    of 1.2.33.
2051
2052  + (Microsoft Windows version): Now using wxWidgets 3.0.4 (was 3.0.2).
2053
2054Changes in 1.2.33 (2018-03-22):
2055
2056* aven:
2057
2058  + Reliably disable scale bar in perspective view.  This is supposed to happen
2059    (because the scale across the screen varies in perspective view) but
2060    actually the scale bar stayed around until an update was forced for another
2061    reason.  Spotted thanks to Pedro Silva Pinto.
2062
2063  + Make "no date"/"not in loop" colour grey.  The white was a bit bright and
2064    made it harder to see the legs that had colours.  The grey now used is
2065    within the brightness range of the other colours.  Fixes #94, reported by
2066    Erin Lynch.
2067
2068  + Fix KML export - exporting both survey legs and station names resulted in a
2069    malformed KML file.  This bug was introduced in 1.2.30 when support for
2070    exporting passages and walls was added.  Reported by Erin Lynch in #90.
2071
2072  + Consistently use 2 decimal places for altitude in KML output.  Some places
2073    used 8 decimal places which is appropriate for lat and long, but clearly
2074    overkill for an altitude in metres and increases the file size
2075    unnecessarily.
2076
2077  + Right-align bearing widget in print/export dialog.  The change to allow the
2078    value to wrap round from 360 to 0 in 1.2.27 inadvertently made this control
2079    left-aligned (due to incorrect wxWidgets documentation of the default style
2080    for this control).
2081
2082  + (Unix version): Work around wxWidgets bug so that custom cursors work
2083    under GTK3.
2084
2085  + (Unix version): Update GTK version reporting - report GTK3, and don't
2086    bother to report subversions of GTK2 (it seems to be fairly arbitrary
2087    which subversions wxWidgets defines constants for).
2088
2089  + Update code to work without warnings when using wxWidgets 3.1.0 (the
2090    current development version).
2091
2092  + Make movie export code compatible with upcoming FFmpeg 3.5 release.
2093    It should still work with the older versions that worked before this
2094    change.  Reported by James Cowgill in https://bugs.debian.org/888334
2095
2096* cavern:
2097
2098  + Warn about 2 digit years.  We can't change the assumption that these are
2099    19xx without risking breaking existing datasets, but the further we get
2100    into this century, the more likely such an assumption is to catch someone
2101    out.  The warning can easily be quashed by explicitly adding the assumed
2102    "19".
2103
2104* The Spanish translation is now up to date once more, thanks to updates from
2105  Evaristo Quiroga.
2106
2107* Merge French translation updates from Jean-Marc.
2108
2109* Fix transposed German Northing and Easting labels.  Fixes #95, reported by
2110  milosch.
2111
2112* Fill in missing translations of "Easting", "Northing", "E" and "N" for
2113  Bulgarian, Greek, Hungarian, Polish and Russian based on other existing
2114  translated messages.
2115
2116* Align .pos file headings better with columns of coordinates below for
2117  Indonesian and Polish.
2118
2119* Fix handling of the message string "error" before messages loaded.  If
2120  there's an error loading messages, we need this message to report it.
2121  Reported by Martin Sluka.
2122
2123* Fix a few compiler warnings.
2124
2125* img library: Fix extracting leaf survey name for survey title.  When there
2126  are three or more levels of survey, we were taking everything after the first
2127  dot rather than everything after the last dot.
2128
2129* Fix problems with testsuite on macOS:
2130
2131  + cavern.tst: Skip "ONELEG" testcase on case-insensitive filing systems
2132    - this test isn't meaningful unless the filing system is case-sensitive,
2133    but happens to fail if it isn't.
2134
2135  + cavern.tst: Workaround limitations of Apple's sed.
2136
2137  + aven.tst: Fix not to hang on macOS.
2138
2139  + smoke.tst: Remove aven testcases which duplicate those in aven.tst.
2140
2141* Clean up handling of support files in relocatable installs - this is now
2142  detected at run time on macOS.
2143
2144* Split out macOS Aven.app creation into a make rule so it can be easily used
2145  by the homebrew formula.
2146
2147* buildmacosx.sh:
2148
2149  + Fix when WX_CONFIG not specified - this was giving a confusing error like:
2150    ./buildmacosx.sh: line 163: --cc: command not found
2151
2152  + Use wxWidgets 3.0.4.
2153
2154* Stop checking wx-config --ldflags as this option was removed in wxWidgets 2.6
2155  and we currently require 2.8 or newer.
2156
2157Changes in 1.2.32 (2017-07-08):
2158
2159* aven:
2160
2161  + Make splays on printouts a darker shade of grey.  Reported by Erin Lynch
2162    and Anthony Day.
2163
2164  + In export formats which include 3 dimensions (DXF, PLT, GPX, KML, JSON,
2165    POS), the value in the Z dimension was negated.  Bug introduced by fixes
2166    for export of rotated plans and tilted elevations in 1.2.27.  Reported by
2167    Erin Lynch in #89.
2168
2169  + Ignore viewing angles for export formats which work in 3D.  When the
2170    rotation and tilt controls are hidden in the export dialog we were still
2171    using their values to transform the data, so if you set them with for one
2172    export format which support them, then switched to an export format which
2173    doesn't, you'd get bogus coordinates in the exported file.  Bug probably
2174    introduced in 1.2.27 by fixes for exports of rotated plans and tilted
2175    elevations.
2176
2177  + Fix exporting to skencil and Survex .pos formats.  When aven's export to
2178    .pos was added in 1.2.19, the ordering didn't match up and since then .pos
2179    export has produced skencil files and vice versa.
2180
2181  + Don't leave terrain on if loading terrain data fails.  Previously if you
2182    clicked the terrain icon (or via the menu) with no terrain loaded, but no
2183    terrain got loaded (e.g. because the survey data lacks an explicit
2184    coordinate system, or because the file failed to load, or because you
2185    cancelled the dialog) then the terrain icon/menu item was still changed to
2186    "on".
2187
2188  + Disable texturing while drawing terrain.  Previously the terrain got a bit
2189    darker when "Textured Walls" were enabled.
2190
2191  + Force a refresh when "Textured Walls" are enabled or disabled.  Previously
2192    the display wouldn't update right away.
2193
2194* Manual:
2195
2196  + Document how to specify fixed point altitude in feet.
2197
2198  + Explain why *fix warns about unused fixed points
2199
2200* Building from source now requires a compiler with decent support for C++11.
2201  If you're using GCC, then GCC 4.7 should suffice.  This should not be an
2202  onerous requirement - e.g. Debian wheezy and Ubuntu trusty both have a recent
2203  enough GCC.  If special options are needed, these should get probed for and
2204  automatically.  Fixes building 1.2.31 with GCC < 6, reported by Wookey.
2205
2206Changes in 1.2.31 (2017-07-01):
2207
2208* aven:
2209
2210  + Use superscript 'g' symbol instead of word 'grads' in status bar.  This
2211    conserves the limited space available, and we already do this in the
2212    compass and clino indicators so it's more consistent too.
2213
2214  + Show one decimal place on measure line bearing.  Pointed out by Benedikt
2215    Hallinger on the therion list, though I'm sure this has been asked for
2216    before by others.
2217
2218  + Show gradient of the measuring line when both ends are stations.
2219
2220  + Allow selection of text in cavern log window.  Selection was disabled in
2221    1.2.28 because it seemed you couldn't actually copy selected text to the
2222    clipboard, but retesting this now actually works fine for me, both with
2223    current git master with the change reverted, and with code just before the
2224    original change.
2225
2226  + More robust parsing of cavern output (cleanly handle context highlighting
2227    which extends beyond the end of the line).
2228
2229  + Allow showing duplicate legs as dashed lines or hiding them entirely,
2230    with dashed now being the default.  Implemented by Patrick Warren.
2231
2232  + Also allow "Dashed" for splays and "Faded" for duplicate legs.
2233
2234  + Splay legs in surface data are also shown faded.
2235
2236  + Check environment variables VISUAL and EDITOR when looking for editor to
2237    use when a warning or error is clicked on in the cavern log window.  The
2238    specified editor may have a GUI or need to run in a terminal, so we have to
2239    special-case each editor supported, and that means we can pass extra
2240    options needed to position the cursor on the appropriate line/column.
2241    Currently these editors are supported: gvim, nvim, vim, gedit, pluma,
2242    emacs, nano, jed, kate.  Suggested by Wookey.
2243
2244  + Fix handling of non-square terrain data files - the X and Y dimensions were
2245    swapped.  Reported by detrito.
2246
2247  + Improve parsing of DEM data with .hdr file.  Use documented defaults for
2248    more values, and where we only support a subset of values (or a particular
2249    value) check for unsupported values in more cases.
2250
2251  + When colouring by depth, fix colouring and texturing of polygons which
2252    cross depth bands.  The previous problems were most obvious with high
2253    chambers and long legs down deep pitches, especially in for surveys without
2254    much vertical range.
2255
2256  + Support for drawing blobs using point sprites was added in 1.2.28,
2257    but caching that this worked wasn't hooked up properly so the test to
2258    see if this worked would happen at the start of each run.  This is now
2259    cached as intended which should reduce start up time a little when blobs
2260    are drawn in this way.
2261
2262  + Fix drawing of crosses with lines.  This is a fall-back case which is
2263    rarely used as most OpenGL setups will handle a better method, but it was
2264    resulting in crosses with a four-pixel square in the centre - now the
2265    centre should be a single pixel.
2266
2267* cavern:
2268
2269  + Allow *data with no arguments to reset the current style - useful for
2270    entering passage data where there are side passages.
2271
2272  + Fix hang processing file without newline at end.  This bug was introduced
2273    by changes in 1.2.28.  Reported by Mark Brown.
2274
2275  + (Mac OS X and Microsoft Windows versions): Build with newer version of
2276    PROJ library which fixes buggy handling of *fix with lat-long coordinates.
2277    Also add a testcase to the testsuite to alert users building for themselves
2278    with an affected PROJ version on any platform.  Reported by Ross Davidson.
2279
2280  + Fix cavern to handle Compass .DAT with no survey team.  Previously this
2281    resulted in the bogus error: Expecting numeric field, found "FROM"
2282    Reported by Erin Lynch.
2283
2284  + Handle UTF-8 "BOM" at start of .svx files.  Unicode doesn't recommend its
2285    use, but Microsoft stuff seems to like to create files with it in, and the
2286    error cavern currently reports for such files is very confusing, so it
2287    seems best to just handle it.  Reported by Rob Eavis.
2288
2289  + Change a couple of messages to use double quotes for consistency with all
2290    other messages.
2291
2292* extend:
2293
2294  + Now runs a bit faster.
2295
2296  + Splays are now carried over the extended survey.  The current handling
2297    is simplistic, but should do a good enough job to be more useful than
2298    discarding splays.  The splays at each station are all rotated together
2299    based on the bearing between the stations either side of the current one
2300    along the first path extended through that station.  This nicely handles
2301    dead ends and the situation at the top or bottom of a pitch, and should
2302    tend to pick an angle close to the passage orientation along a traverse.
2303    It's weakest at junctions.  Feedback (especially examples which could
2304    be handled better) most welcome.
2305
2306* French translation is now up to date again, thanks to Jean-Marc.
2307
2308* Remove erroneous menu shortcut markers from Polish translations.
2309
2310* Fill in some missing translations in several languages by using message
2311  translations from therion.
2312
2313* Add note to *fix documentation to clarify the coordinate order with *cs
2314  long-lat.  Issue raised by Ross Davidson.
2315
2316* Fix errors in documentation of *units: "DEG" should be "DEGS", and
2317  "MINUTES" has been supported for ages but wasn't documented.  Reported by
2318  Footleg.
2319
2320* Fix a few typos in the documentation.
2321
2322* Fix compilation warning with recent GCC.
2323
2324Changes in 1.2.30 (2016-10-03):
2325
2326* aven:
2327
2328  + (Microsoft Windows version): Fix crash when trying to print or export
2329    (probably introduced in 1.2.28).  Reported by Brian Clipstone.
2330
2331  + Report error if terrain file contains no terrain data in area of survey.
2332    Suggested by detrito.
2333
2334  + Errors when writing an export file were reported with the wrong filename
2335    - the .3d file, not the filename we were trying to write to.
2336
2337  + Export to KML now supports exporting passages, walls and cross-sections.
2338    Addresses the remainder of ticket #4.
2339
2340* Add man page for dump3d.
2341
2342Changes in 1.2.29 (2016-09-27):
2343
2344* aven:
2345
2346  + Fix SVG output with non-ASCII characters (the charset in the SVG file
2347    is now set to UTF-8 not ISO-8859-1).
2348
2349  + (Microsoft Windows version): Fix error dialog on startup in pre-built
2350    version.  Reported by Brian Clipstone.
2351
2352* Manual: Add link to TerrainData wiki page.  Omission highlighted by Erin
2353  Lynch and "detrito".
2354
2355* Fix to build without FFmpeg/libav and with older versions, broken by changes
2356  in 1.2.28.  Reported by James Begley.
2357
2358Changes in 1.2.28 (2016-09-24):
2359
2360* cavern:
2361
2362  + Show the contents of the line after error and warning messages while
2363    processing survey data, and indicate the region of the line in many cases
2364    in the same style that compilers such as GCC and clang use (using the
2365    column number we already have, plus new width information).  Based on a
2366    patch from Mateusz Golicz.
2367
2368  + Add column and width information for many more error and warning messages.
2369
2370  + Fix column for "Separator in survey name" warning.
2371
2372  + Improve warnings when using a backclino with range 0-180 degrees (reusing
2373    the same machinery we already have for a forward clino with range 0-180
2374    degrees).
2375
2376* aven:
2377
2378  + Include LRUD in printout/export of extended elevations, broken by
2379    improvements to export of tilted elevations in 1.2.27.  Reported by Anthony
2380    Day.
2381
2382  + Name <trk> tags in GPX output, so Garmin GPS units name the imported track
2383    usefully.  Reported by Anthony Day.
2384
2385  + Remember scale from previous print or export operation in the same run of
2386    aven.  Suggested by Stuart Bennett.
2387
2388  + Convert range indication below shown line to a highlight on that region
2389    of the line in cavern log window.
2390
2391  + Fix colouring of error/warning without column in cavern log window.
2392
2393  + Fix click on error/warning without column in cavern log window.
2394
2395  + Fix highlight of translations of "error" or "warning" containing non-ASCII
2396    characters.  This fix for this only works with a Unicode build of
2397    wxWidgets, but as of wxWidgets 3.0, all builds are Unicode, so this
2398    shouldn't be much of a problem as wxWidgets 2.x is close to obsolete now.
2399    Reported by Mateusz Golicz.
2400
2401  + Disable selection of text in cavern log window - you can't currently copy
2402    it to the clipboard, so until that's implemented it seems better to disable
2403    the ability to select it.  Reported by Wookey.
2404
2405  + Avoid special "1000" scale entry when exporting.
2406
2407  + Show 1 page when "One Page" selected.
2408
2409  + Reload processed data when restricting view.  Fixes failure when
2410    restricting view on data just processed via aven.  Spotted by Andrew
2411    Atkinson and myself.
2412
2413  + Don't hide blobs and crosses behind terrain.  Reported by Jenny Black.
2414
2415  + Fix rendering of crosses using point sprites.  The texture being used was
2416    misaligned relative to the image used for the visual fidelity check, so the
2417    check always failed and point sprites would never be used.  Where point
2418    sprites are supported, they're probably the fastest option - on my netbook
2419    this change improves FPS by ~6 fold when displaying crosses for a large
2420    survey.
2421
2422  + Support drawing blobs using point sprites.  About 5 times faster than using
2423    lines on my netbook.
2424
2425  + Recheck how best to draw crosses and blobs on the first run after Survex
2426    is upgraded (or downgraded) as the rendering code may have changed (we
2427    already recheck when the OpenGL hardware or driver changes).
2428
2429  + Change "MPEG" export to be MPEG4 (.mp4) rather than MPEG1 (.mpg).
2430    MPEG4 produces smaller output of higher quality, and should be widely
2431    supported these days.  And I can't get the MPEG1 output to work without
2432    buffer underflows, resulting in a file which doesn't play without
2433    glitches.
2434
2435  + Add OGG video to the list of formats - it's more compact than the others
2436    we currently list, though slower to write.
2437
2438  + Fix export to movie formats for which libav/FFmpeg needs to seek the file
2439    being written.  This was broken by changes in 1.2.27.
2440
2441  + Overhaul movie export for the current FFmpeg API, fixing deprecation
2442    warnings when building against a recent version.
2443
2444  + (Microsoft Windows version): Fix corrupted exported movie files.  1.2.27
2445    changed the movie export code to allow writing to files with non-ASCII
2446    characters in the names, but the new code failed to open the file in binary
2447    mode, leading to corrupt output.  Fixes #81, reported by Erin Lynch.
2448
2449  * (Microsoft Windows version): Pre-built version now uses FFmpeg 3.1.3 for
2450    movie export.
2451
2452  * (Mac OS X version): Pre-built version now uses FFmpeg 3.1.3 for movie
2453    export.
2454
2455* Fix to build without FFmpeg/libav, broken by changes in 1.2.27.  Reported by
2456  James Begley.
2457
2458* The Polish translation is now very close to being complete, thanks to a
2459  substantial update from Mateusz Golicz.
2460
2461* Merge catalan translation updates from Adolfo Jayme.
2462
2463* (Microsoft Windows version): Map LANG_CHINESE to zh_CN not zh so Chinese
2464  messages get used automatically.
2465
2466* cavern.tst: Remove random : from after ] - dash ignores the extra character,
2467  but it causes this test to fail if /bin/sh is a different shell (e.g. bash).
2468
2469* cavern.tst: Add expected output for more testcases.
2470
2471* Remove unwanted execute bit from some testcase data.
2472
2473* Use https for more URLs which support it.
2474
2475Changes in 1.2.27 (2016-06-06):
2476
2477* aven:
2478
2479  + Right click on a survey in the survey tree now gives a pop-up menu
2480    with "Hide others", which restricts the view to just that survey
2481    and any subsurveys.  Right click on the root of the survey tree
2482    gives a menu with "Show all" to undo any restriction in effect.
2483    (Currently these are implemented by reloading the file and using
2484    the same machinery as the --survey= command line option, but that will
2485    probably change in the future).
2486
2487  + If there's a sub-survey restriction (from the --survey= command line
2488    option or the new UI described above) it is now shown in brackets after
2489    the survey tree root.
2490
2491  + When reloading a survey, preserve the current view position (previously
2492    the view was recentred).
2493
2494  + When reloading a survey, actually preserve the current scale factor
2495    (this was meant to happen, but the adjustment was applied in the
2496    wrong direction).
2497
2498  + New "File->Extended Elevation..." menu item provides a way to generate
2499    extended elevations for simple cases without having to use the command
2500    line.  Suggested by Fleur Loveridge.
2501
2502  + Don't process key presses if accompanied by an unexpected modifier key.
2503    In particular, this means that aven no longer interferes with Alt+<function
2504    key> (which is typically handled by the desktop) and Alt+<letter> (which is
2505    typically a menu short cut).  Reported by Владимир Георгиев.
2506
2507  + Reduce file loading time by ~5%.  The station name compare function was
2508    something of a hot spot, and optimising it yielded a nice improvement.
2509
2510  + Allow splay legs to be disabled in when printing and exporting.  Mostly
2511    addresses #60.
2512
2513  + SVG export now shows splay legs thinner and in grey.  See #60.
2514
2515  + Fix export of rotated plans and tilted elevations - previously plans were
2516    always aligned with North up, and elevations which weren't exactly side on
2517    were exported as plans.  Reported by Stuart Bennett.
2518
2519  + Fix offset bounding box for exported elevations.
2520
2521  + In print/export dialog the bearing value now wraps if you scroll up past
2522    360 or down past 0.
2523
2524  + Fix greying out of LRUD-based controls in the print/export dialog when the
2525    view is tilted (i.e. not plan or elevation).  This stopped working in
2526    1.2.18 when the pan and tilt spin controls were changed from integer- to
2527    real-valued ones.
2528
2529  + Printouts now show LRUD as pale grey arrows from the station they are
2530    measured from.  Based on patch from Michael Sargent.  Closes #65.
2531
2532  + Take LRUD into account for printout size.  Fixes #72, reported by Erin
2533    Lynch.
2534
2535  + Update movie export code to work with latest version of FFmpeg.
2536
2537  + Make "Show Log" a toggle, so you can click on the button to take a look at
2538    the log, and a second click returns you to the survey view.
2539
2540  + (Microsoft Windows version): Open the font file in binary mode - it looks
2541    like we were lucky and the font file (or at least its current version)
2542    would have loaded OK in text mode despite being binary data.
2543
2544  + (Microsoft Windows version): Exporting to files with non-ASCII filenames
2545    should now work.
2546
2547* cavern:
2548
2549  + Allow tape or backtape to be omitted.  Reported by Erin Lynch.
2550
2551  + Grid convergence is now corrected for when using automatically
2552    calculated declinations (*declination auto <X> <Y> <Z>).  Requested
2553    by Mateusz Golicz on the mailing list.
2554
2555  + Clear any cached calculated declination upon another *declination auto
2556    with different coordinates.  Previously if the date stayed the same,
2557    a previously cached declination for the old coordinates was used.
2558
2559  + Fix check for end of version number array in *require.  We would check up
2560    to 12 version components, the last 9 being bogus.  In practice, *require is
2561    only likely to be used with up to three components, so this wouldn't be an
2562    issue.
2563
2564  + *begin with an invalid prefix could cause a crash in some cases.  Fixed
2565    by patch from Colin Watson.
2566
2567  + Report column locations for errors to do with readings.
2568
2569* Merge translation updates from Jean-Marc.
2570
2571* img library: Better document which members can be set when writing.
2572  Highlighted by email query about use of img API from Владимир Георгиев.
2573
2574* Document how *declination interacts with *calibrate declination if both are
2575  used in the same dataset.
2576
2577* doc/3dformat.htm: Update details of how changes to the current label buffer
2578  are encoded to reflect changes in v8.  Reported by Angus Sawyer.
2579
2580* Use docbook2man instead of docbook-to-man to generated Unix man pages
2581  from SGML source.  The latter seems to be no longer actively maintained, and
2582  docbook2man now does a similarly good job.
2583
2584* Use https for survex.com links, and for other sites which support it.
2585
2586Changes in 1.2.26 (2016-01-07):
2587
2588* aven:
2589
2590  + (Microsoft Windows version): Fix to be able to process .svx files with
2591    cavern again.
2592
2593* (Microsoft Windows version): Simplify upgrading process with innosetup
2594  installer - if Survex is already installed, we now just install to the same
2595  location and use the same start menu folder.
2596
2597* (Linux version): survex.spec: Update for filetype metadata change in 1.2.25.
2598  Fixes #79, reported by James Begley.
2599
2600* (Linux version): survex.spec: Fix to work with RPM 4.13.  Fixes #79, reported
2601  by James Begley.
2602
2603Changes in 1.2.25 (2016-01-05):
2604
2605* aven:
2606
2607  + Drop broken code which attempts to fix 2D pitches.  Fixes #73, reported by
2608    Erin Lynch.  #76 tracks the issue the removed code was trying (but failing)
2609    to address.
2610
2611  + When animating, don't try to update station info based on mouse movement
2612    over the survey tree.
2613
2614  + Further improve code to handle cavern subprocess in aven.
2615
2616  + Fix jump to error for filenames containing colons when the error location
2617    doesn't have a column number.  Bug noted by Jenny Black.
2618
2619  + If we encounter bad UTF-8 in cavern output, replace it with a red and white
2620    ? in a diamond (previously we gave up showing output at the first bad
2621    sequence).  This can happen if you process a .svx file which isn't UTF-8
2622    encoded.
2623
2624  + (Unix version): Don't try to set the terminal window title when opening an
2625    editor from the cavern log window - gnome-terminal no longer supports this,
2626    and there doesn't seem to be a portable option for specifying the title for
2627    terminals which do still support this.
2628
2629  + (Microsoft Windows version): Also quote for cmd.exe so that paths with
2630    spaces in work reliably.  Reported by Marco Cotto.
2631
2632* cavern:
2633
2634  + Improve error for mismatched fore/back-sight plumbs, reported by Andy
2635    Edwards (see #78).
2636
2637  + Fix to use correct sd for backcompass.  We were using zero instead, the
2638    most obvious effect of which was that the threshold for warning about
2639    differing COMPASS and BACKCOMPASS was about 71% of what it should have
2640    been, so we were warning in more cases than we should have been.
2641
2642  + Implement support for specifying a length on backsights - if you're using
2643    something like a disto-x, you'll get a distance reading for the backsight
2644    too.  Fixes #71, reported by Erin Lynch.
2645
2646  + Make line counting more robust to mixed line ends.  Noticed in example file
2647    from Pete Smart (see #69).
2648
2649* extend: New --show-breaks option which adds a leg flagged as surface survey
2650  between each points at which a loop has been broken.  Suggested by Jenny
2651  Black.
2652
2653* (Unix version): Update filetype metadata to work with modern desktops.
2654
2655* Fix incorrect reporting of errors reading and writing processed survey data.
2656  Since 1.2.8, the error strings corresponding to IMG_CANTOPENOUT,
2657  IMG_BADFORMAT and IMG_DIRECTORY have been mixed up (this doesn't affect
2658  external programs using the img library, only Survex).  Reported by Jenny
2659  Black.
2660
2661* Add missing options to extend man page and --help output.  Noted by Jenny
2662  Black.
2663
2664* Document Document Ctrl+cursor keys for rotating and tilting in aven man page.
2665
2666* Fix broken SGML markup in manual.
2667
2668* Fix typo in manual reported by Jenny Black.
2669
2670* Update vim syntax file for newer commands, etc.
2671
2672* Minor translation updates.  Thanks to Piotr Strębski and Jean-Marc.
2673
2674* Fix to compile with FFmpeg 2.9.  Reported by Andreas Cadhalpun in
2675  https://bugs.debian.org/803863
2676
2677* Stop maintaining ChangeLog files.  They make merging patches harder, and stop
2678  'git cherry-pick' from working as it should.  The git repo history should be
2679  sufficient for complying with GPLv2 2(a).
2680
2681* (Microsoft Windows version): The installer requires admin privileges on Vista
2682  and later and OS versions older than Vista are past end of life, so drop code
2683  which tries to set up the registry differently depending if we have admin
2684  privileges or not.
2685
2686Changes in 1.2.24 (2015-09-23):
2687
2688* aven:
2689
2690  + (Microsoft Windows version): Fix the cavern log window.  Reported by Brian
2691    Clipstone.
2692
2693  + (Microsoft Windows version): Add workaround to avoid breakage in Therion.
2694    Reported by Jenny Black.
2695
2696  + If wx was built with thread support, aven now runs cavern from a separate
2697    thread, which works much better under wxMSW (where we can't use select),
2698    and also seems a bit smoother on Linux.
2699
2700  + Fix handling of encoding of filenames when the operating system has no
2701    locale installed corresponding to the language selected for Survex's
2702    messages.
2703
2704  + Undo accidentally committed debugging code which was sending message to
2705    the terminal in 1.2.23.
2706
2707* (Linux version): configure now looks first for wx-config-3.0, which Fedora's
2708  wx3 packages have.  Reported by James Begley.
2709
2710* Indonesian translation fully up to date again.
2711
2712* Manual: Document anonymous stations, based on the text from NEWS.  Reported
2713  by Wookey.
2714
2715Changes in 1.2.23 (2015-09-06):
2716
2717* aven:
2718
2719  + Updating the cavern log window is now much smoother, especially on slower
2720    machines.
2721
2722  + Show "busy" mouse cursor while processing survey data.
2723
2724  + Fix an assertion if you try to start processing a survex file while one is
2725    already being processed.
2726
2727  + Processing a .svx file with an error now still adds it to the file history.
2728    Reported by Martin Green.
2729
2730  + Fix the orientation of the starting end of tubes.
2731
2732* cavern:
2733
2734  + New *ref command to allow specifying an external reference (e.g. where to
2735    find the original survey notes).
2736
2737  + Drop support for showing percentage progress in cavern.  It's confusing in
2738    a multiple-file dataset as it shows progress in the current file so jumps
2739    around.  It also slows down processing, and on a slow machine you'd don't
2740    want that, while on a fast machine processing isn't slow enough for the
2741    progress display to be useful.
2742
2743* French translation is now completely up to date, thanks to Michel Bovey.
2744
2745* Bundle proj's EPSG and ESRI code lists in the installers for MS Windows and
2746  OS X so that things like "*cs EPSG:29903" work.  Reported by Graham Mullan.
2747
2748* (Microsoft Windows version): Process survey data with aven rather than
2749  running cavern.
2750
2751* (Microsoft Windows version): Installer built with InnoSetup 5.5.6 (recent
2752  releases have been built with 5.5.3) to see if that solves Ray Duffy's
2753  reported issue with not having file associations for .svx files created.
2754
2755Changes in 1.2.22 (2015-08-17):
2756
2757* aven:
2758
2759  + Ensure that the window has a depth buffer.  Whether it does by default
2760    seems to vary depending on OS and maybe graphics card.  Fixes #55 (terrain
2761    is no longer visible through itself), and also the rendering of passage
2762    tubes.  Thanks to Martin Green for pointing me in the right direction for
2763    finding this fix.
2764
2765* cavern:
2766
2767  + Fix *declination with an angle to actually work.
2768
2769  + Fix assertion if we try to identify a hanging survey by an anonymous
2770    station.
2771
2772  + Improve errors for invalid survey names in *begin, *end, *equate and
2773    *export.
2774
2775Changes in 1.2.21 (2015-07-28):
2776
2777* aven:
2778
2779  + Fix exporting to KML and other text-based formats to always use "." for the
2780    decimal separator - previously "," would be used when the user's locale
2781    specified this for the decimal separator.  Reported by Jan Schorn.
2782
2783  + Implement exporting of survey legs in KML format.
2784
2785  + Put "paddle" placemarker icons on stations in exported KML files, using the
2786    same colour coding for entrances, fixed points and exported points as aven
2787    does.
2788
2789  + Remove the "Coordinate projection" field from the print dialog, as it isn't
2790    relevant there.  Reported by Wookey.
2791
2792  + Fix the initial scale for small caves (since 1.2.18 the initial scale has
2793    been too small).  Reported by Wookey.
2794
2795  + Don't rescale if the same file is reloaded, but adjust the volume diameter
2796    as appropriate.
2797
2798  + Use wxGetenv() to read the SURVEXEDITOR variable, so we can accept Unicode
2799    values on Windows.
2800
2801* cavern:
2802
2803  + Fix coordinate systems using latitude and longitude - PROJ.4 wants these in
2804    radians, but we were passing degrees, which would generally cause the
2805    conversion to the output coordinate system to fail.  Reported by Wookey.
2806
2807  + Fix *fix with standard deviations when *cs is in use, give an error for use
2808    of *fix with standard deviations before *cs.
2809
2810  + Add new *declination command with support for setting the declination
2811    automatically from the IGRF model based on the survey date.  Thanks to the
2812    Therion developers for the IGRF support code, which we're reusing.
2813    Fixes #54, reported by Wookey.
2814
2815  + Allow the units for the zero error to be specified, making it easier to
2816    specify calibration with a scale if you measure the zero error externally
2817    (rather than using the instrument itself).  Fixes #61, reported by Andrew
2818    Atkinson.
2819
2820  + Report the error from PROJ when coordinate conversion fails as part of the
2821    actual error rather than on a separate line.
2822
2823  + Fix use after free after *solve.  This only occurs if a leg between the two
2824    exact same stations appears right before and right after the *solve, which
2825    is unlikely in real data, but the testsuite has an instance of this.  This
2826    was introduced by the repeat leg averaging added in 1.2.17.
2827
2828  + Fix small memory leak when solving network.  This doesn't really matter
2829    when solving at the end of processing as cavern will exit after that, but
2830    if *solve is used we continue processing after solving.
2831
2832* Remove compatibility handling for specifying a country variant of a language
2833  in SURVEXLANG using "-" with a lower case country code (e.g. "en-us") - we
2834  changed to the standard "en_US" way back in 2001.  This code was mangling
2835  character sets with a "-" in, and is no longer useful.
2836
2837* Ignore any "@<something>" modifier in the language code.
2838
2839* Improve documentation of magnetic declination handling, and cover the new
2840  "*DECLINATION" command.
2841
2842* Document aven's command line options in the manual and its man page.
2843  Reported by Jenny Black.
2844
2845* Point to '*case' and '*truncate' from the 'SEE ALSO' sections of each other's
2846  documentation.
2847
2848* Remove references to SpeleoGen from the documentation - it hasn't been
2849  updated for many years, and can't read recent versions of the .3d format.
2850
2851* Strip documentation references to obsolete versions of MS Windows.
2852
2853* doc/HACKING.htm: Update list of debian packages to install to build from git.
2854
2855Changes in 1.2.20 (2015-06-26):
2856
2857* aven:
2858
2859  + When printing, use the top margin rather than the right margin to calculate
2860    the height of the printable area.  In practice, the two values seem to be
2861    the same or very similar by default.
2862
2863  + Avoid assertion if the about dialog image fails to load.  Reported by Phil
2864    Maynard.
2865
2866  + Optimise the size of the about dialog images.
2867
2868  + Add support for reading terrain data which isn't in a .zip file.
2869
2870  + Force a refresh after loading terrain data so that it gets displayed right
2871    away.
2872
2873  + Make checks for terrain data extensions in zip files case insensitive.
2874
2875  + If reading terrain data fails, always report an error and never try to
2876    display it.
2877
2878* cavern: Allow clino readings in diving style data, suggested by Andrew
2879  Atkinson.  Currently these readings are ignored, but a future version will
2880  check that they're consistent with the angle given by the depth gauge and
2881  tape, and perform suitable averaging.
2882
2883* Remove lingering traces of svxedit.
2884
2885* configure: Fix to allow compiling without libav/ffmpeg, as was possible
2886  before 1.2.19.
2887
2888* (Unix version): Install the filetype and aven application icons under
2889  /usr/share/icons/hicolor, which is where they're expected to be these days.
2890
2891* (Unix version): Add %f to Exec in survex-aven.desktop.
2892
2893* (Mac OS X version): Remove useless extra copy of about box images from OS X
2894  disk image.
2895
2896* (Mac OS X version): Only ship one copy of each of the translations.
2897
2898* (Mac OS X version): Reduce the size of the aven binary by disabling a load of
2899  libav features we don't use.
2900
2901* (Microsoft Windows version): Reduce the size of the aven binary by disabling
2902  a load of libav features we don't use.
2903
2904* (Microsoft Windows version): Update message files to fix a missing Chinese
2905  message in the installer.
2906
2907Changes in 1.2.19 (2015-06-18):
2908
2909* aven:
2910
2911  + Fix exporting to GPX, KML and HPGL, which all failed to write the header to
2912    the exported file in 1.2.18.
2913
2914  + Add exporting to Survex .pos format.
2915
2916  + If the measuring line isn't currently active, pressing "Escape" will now
2917    exit full screen mode.
2918
2919  + (Mac OS X version): Change the shortcut for full screen mode to be the
2920    standard Ctrl+Command+F (rather than Shift+Command+F which we have been
2921    using since 1.2.7).
2922
2923  + (Mac OS X version): When we centre the view on the station this can
2924    generate a mouse move event, so clear the variable which says we are
2925    dragging before we process a left click on a station.  This avoids random
2926    rotations of the survey when clicking on a station, reported in #47 by Hugh
2927    St. Lawrence.
2928
2929  + (Mac OS X version): Force use of a non-native toolbar to stop the toolbar
2930    icons from being rescaled and looking fuzzy.
2931
2932  + (Mac OS X version): Remove code added in 1.2.18 which tries to set stop the
2933    toolbar icons from being rescaled, but which requires an unreleased version
2934    of wxWidgets, had a typo in, and doesn't actually seem to work anyway.
2935
2936  + (Mac OS X version): Drop out of full screen mode if the mouse is mode to
2937    the top of the screen, since we can't seem to display the menu bar in this
2938    case like we do on other platforms.
2939
2940  + (Mac OS X version): Enable aven's movie export feature.
2941
2942  + (Mac OS X version): Enable wxDisplay when building wxWidgets to better
2943    support multi-monitor setups.
2944
2945  + (Mac OS X version): Silence warning visible when aven is run from a
2946    terminal about a missing CFBundleTypeRole.
2947
2948  + When reading terrain data from a .zip file, report an error if the .zip
2949    file is bad, or if it doesn't contain any terrain data we recognise.
2950
2951  + Tweak error message in terrain reading code to distinguish two failure
2952    cases.
2953
2954  + Add viewing angles and scale to footer, and shorten some of the other items
2955    to make room for this extra information.  (Fixes ticket #52, reported by
2956    Erin Lynch)
2957
2958  + If the footer is wider than the printout width, scale down the font used
2959    so that it exactly fits; if the footer is narrower, than space out the
2960    items in in so it uses the full width.
2961
2962  + If the saved size for aven's window exceeds the current display size
2963    (mostly likely because we're now plugged into a smaller monitor), then
2964    reduce the size of the window to fit the display.  If the saved size is <
2965    (480x320), increase it to at least that, as aven isn't usable in a smaller
2966    window.
2967
2968  + Remove crude bodge which tries to pick a nicer initial window size when
2969    using wxWidgets without wxDisplay on a multi-monitor setup - aven now opens
2970    with the same size window it had when it was closed, so the initial size is
2971    only relevant on the first ever run.
2972
2973* Assorted translation updates.  Notably Indonesian is at 100% again.
2974
2975* Stop trying to catch and report signals.  The only real reason to do it is so
2976  we can say "Bug in program detected! Please report this to the authors"
2977  before we exit, but when the program crashes that's pretty obvious.  In aven
2978  we try to pop up a message box for this message, which may fail due to
2979  whatever caused the signal, while with the command line tools there's no
2980  great benefit over just letting the shell report the signal.
2981
2982* Use pkg-config to probe for libav and proj, which sorts out the correct flags
2983  for building on OS X against a static install of libav.
2984
2985Changes in 1.2.18 (2015-06-03):
2986
2987* aven:
2988
2989  + Add support for reading terrain data (from a zip file containing either an
2990    SRTM .hgt file, or an ESRI .bil file and associated metadata files), and
2991    rendering it as a transparent surface.
2992
2993  + Remove actions from 'Orientation' and 'Rotation' menus which you wouldn't
2994    sanely want to perform from the menu.
2995
2996  + Create a "Colour by" submenu of the "View" menu to house the various
2997    colouring options.
2998
2999  + Add "Colour by Gradient" and "Colour by Length".
3000
3001  + Make the button to dismiss the "About" dialog "OK" rather than "Close",
3002    which seems more logical, and also allows the dialog to be closed by
3003    pressing "Escape".
3004
3005  + Destroy any existing clipping region before we write the page footer.
3006    Hopefully solves ticket #52, reported by Erin Lynch.
3007
3008  + Don't round bearing and tilt angles to integers when printing and
3009    exporting.
3010
3011  + Add passage export for EPS format.  (Partly addresses ticket #4)
3012
3013  + Add JSON export.  This should be regarded as experimental, and the format
3014    is quite likely to change.
3015
3016  + Pressing F6 now toggles the display of rendering stats, currently FPS
3017    (Frames Per Second) and the number of triangles in the terrain mesh.
3018
3019  + Add a menu item and toolbar button to show the cavern log window if the
3020    currently shown survey data was processed by aven.  Reported by Hugh St
3021    Lawrence in #47, and by Dave Clucas and others previously on the list.
3022
3023  + Add "Save Log" button to Aven's cavern log window.
3024
3025  + In cavern log window, highlight "error" markers in red and "warning"
3026    markers in orange.
3027
3028  + Rework code to read cavern's output.  In particular, we no longer mix
3029    buffered and non-buffered system calls.
3030
3031  + Aven's support for reading colours and font sizes for printouts from
3032    print.ini has never worked - the contents of the ini files are ignored due
3033    to a bug which has been there since the code was added in 2005 - but nobody
3034    has ever complained.  So just strip out that code entirely - we should
3035    support setting the colours and font sizes, but a GUI interface for setting
3036    them would be better.
3037
3038  + Fix to compile with a Unicode build of wxWidgets 2.8.  Reported by Bill
3039    Gee.
3040
3041  + Take the width of the messages used above the compass and clino into
3042    account when calculating how much space to allow for them - now the labels
3043    won't overlap or be cut off in translations where they are long.
3044
3045  + (Mac OS X version): Attempt to address the size of the toolbar icons.
3046
3047* cavern:
3048
3049  + Reject *fix with SDs which aren't all positive.  (fixes#2, reported by
3050    susscorfa).
3051
3052  + Use the currently set units when outputting measurements in warnings,
3053    errors, and the stats at the end of the run.  Requested by Bill Gee.
3054
3055  + Include column number when a *include file isn't found.
3056
3057  + Show 'error' in front of error messages, like we show 'warning' in front of
3058    warnings.  Fixes #48, reported by Wookey.
3059
3060  + Increase the threshold for warning that fore and back measurements differ
3061    from 2 SDs to 3 SDs.
3062
3063* findentrances: If the 3d file specifies the coordinate system, use it.
3064
3065* svxedit: Remove svxedit - while an editor with built-in knowledge of survex
3066  would be nice to have, svxedit doesn't really offer that, and it looks ugly
3067  in a modern desktop.
3068
3069* If we run out of memory while reading a processed survey data file, include
3070  the filename in the error message.
3071
3072* Many translation updates - notably Indonesian and Russian are now the two
3073  most complete translations.
3074
3075* (Microsoft Windows version): Add code page 1252 mappings for fancy quotes.
3076
3077* Transliterate gradient and infinity symbols if the current character set
3078  lacks them.
3079
3080* Add SVG version of .plt icon.
3081
3082* Manual:
3083
3084  + Add complete list of quantities you can set SDs for.  Thanks for Wookey for
3085    highlighting that the previous list was incomplete.
3086
3087  + Document averaging of a group of repeated readings.
3088
3089  + Add a link to the sample data from the manual.
3090
3091  + Remove references to contact addresses which are no longer there.  Remove
3092    offer to post people floppies, and references to a CD image which isn't
3093    available for download.
3094
3095* Remove non-breaking spaces from the diffpos and extend manual pages, as they
3096  actually make the output formatting worse (presumably these used to work
3097  around a since-fixed bug in one of the docbook processing tools).
3098
3099* doc/TODO.htm: Update.
3100
3101* Fix to compile without warnings with 'g++ --std=gnu++11'.
3102
3103Changes in 1.2.17 (2015-02-24):
3104
3105* MacOS X version:
3106
3107  + Update INSTALL file with current status.
3108
3109  + Aven.app now has a custom icon.
3110
3111  + Add icons for all the filetypes supported.
3112
3113  + Add Finder actions for .svx, .3d, .plt and .pos files.
3114
3115  + aven: Hide the status bar and tool bar in Full Screen mode, as wx doesn't
3116    currently do this for us.
3117
3118  + aven: Fix short-cut for toggling Full Screen mode.
3119
3120  + aven: Make "About" menu item appear.
3121
3122  + aven: Fix "Close" button in about dialog.
3123
3124  + aven: Make custom cursors black with a white outline to match the standard
3125    OS X cursor.
3126
3127  + svxedit: Now wrapped up in an application bundle as svxedit.app.  It
3128    still doesn't really work like a standard app though - e.g. you can't load
3129    files from Finder (instead run svxedit.app and use File->Open), the font
3130    size of most menu items is wrong, the icon for the app is the wish icon
3131    rather than the svxedit icon, shortcuts use Ctrl not the Cmd key, and
3132    probably more.  I'd probably recommend using another editor (OS X comes
3133    with TextEdit.app for example).
3134
3135  + The documentation is now in a "Docs" directory alongside the apps, rather
3136    than in the rather less obvious "share/doc/survex" directory.
3137
3138  + Default to building for x86_64, since all modern Macs are 64 bit.
3139
3140  + Disable use of liblzma when building wxWidgets for OS X, which was
3141    preventing the build from working on OS X 10.6.8.
3142
3143  + Download wx sources from SF via redirecting link.  Thanks to David A.
3144    Riggs.
3145
3146  + buildmacosx.sh: Handle the mount point for the disk image containing a
3147    space.
3148
3149  + Link with a static build of PROJ for doing coordinate system conversions.
3150
3151  + Build wx with --disable-webview to avoid a compilation failure on OS X
3152    10.10.1.
3153
3154  + Use wx-config --cc and --cxx to get the compilers to use for building
3155    everything else, as wx adds options to them which otherwise cause linking
3156    errors.
3157
3158  + The diskimage (.dmg) file is now compressed with bzip2, which gives a
3159    smaller download.  This means OS X 10.4 is required, but we probably
3160    already need at least 10.5 because that's the minimum version which the
3161    wxWidgets build supports by default.
3162
3163  + Remove unused files and copies of files from the diskimage.
3164
3165* cavern: If the same leg is repeated consecutively, average the readings and
3166  treat as a single leg.
3167
3168* dump3d: Report SEPARATOR used by the file being read.
3169
3170* aven.svg: Fix visual glitch in SVG icon for aven.  Noted by David A. Riggs.
3171
3172* aven:
3173
3174  + Greatly reduce flicker when mouse is moved to the top of the screen in full
3175    screen mode and the menu bar reappears.
3176
3177  + For export formats where scaling is supporting, aven now actually uses the
3178    scale specified in the export dialog (previously it ignored this and used
3179    1:500).
3180
3181  + Reimplement animation so that it's based on angular change per unit of
3182    elapsed time, rather than averaging the time take for the last two scene
3183    redraws.  This gives smoother animation in the face of variable load and
3184    scene redraw time, and should be more consistent between platforms.
3185
3186  + Switching to a point of the compass during auto-rotation now jumps straight
3187    there rather than the two animations fighting.
3188
3189  + Reduce the maximum auto-rotation speed, as the previous limit was uselessly
3190    fast.
3191
3192  + Disable stepping the rotation angle when animating (previously we only did
3193    when rotating).
3194
3195  + Speed up start-up a bit - rather than loading icons from individual PNG
3196    files on disk, compile them into the aven binary.
3197
3198* (Unix version): Add "MimeType" field to desktop files so that file
3199  associations work out of the box with modern desktop environments.
3200
3201* Add start of Hungarian translation from Imre Balogh.
3202
3203* Merge in many updates to the Russian translation from "vsuhachev".
3204
3205* Assorted minor updates to other translations.
3206
3207* Create scalable (SVG) versions of file type icons.
3208
3209* doc/manual.sgml: Remove $Id and $Date markers, as they don't get expanded now
3210  we're using git.
3211
3212* tests/: Improve test coverage in a few places:
3213
3214  + Extend tests of fore and back sights to test calibration of the back
3215    compass.
3216
3217  + Test "Can't calibrate angular and length quantities together" error.
3218
3219  + Check that "*set names ." works when "." is also the decimal point.
3220
3221Changes in 1.2.16 (2014-10-17):
3222
3223* aven: Add KML export (stations only currently).
3224
3225* aven: Allow measuring line to measure from anonymous stations.  (Fixes #44)
3226
3227* aven: Fix corrupted names in exported files.
3228
3229* aven: Fix error log window under wxWidgets >= 2.9 to include the system
3230  information before the first log message like it does under wxWidgets 2.8.
3231
3232* cavern: Add support for "*cs JTSK" and "*cs JTSK03".
3233
3234* tests/: Improve test coverage.
3235
3236* Translation updates for many languages, plus the start of translations to
3237  Greek and Polish.
3238
3239* Fix to build against wxWidgets 3.0 built with assertions disabled.  Reported
3240  by Martin Sluka.
3241
3242* Fix warnings when compiling with clang (which is the default compiler on
3243  Mac OS X).  Reported by Martin Sluka.
3244
3245Changes in 1.2.15 (2014-08-14):
3246
3247* cavern: The *cs command now also supports "long-lat", "s-merc" (for "Web
3248  Mercator"), EPSG and ESRI codes, "eur79z30", "ijtsk" and "ijtsk03".  This
3249  means that we now support all the coordinates systems which Therion does,
3250  except for a few which don't have X=East and Y=North.  The documentation
3251  for *cs has also been improved.
3252
3253* aven: We no longer persist full screen mode between runs - it's not a
3254  standard behaviour of desktop programs, and it's too easy to go into full
3255  screen mode from the menu and then not be able to get out again because you
3256  don't know the required key shortcut. (ticket#39)
3257
3258* aven: When in full screen mode, moving the mouse to the top of the screen now
3259  makes the menu bar appear.  This provides a non-shortcut way out of full
3260  screen mode, as well as making it easier to perform other operations while in
3261  full screen mode.  The current implementation gives an annoyingly flickery
3262  transition, but hopefully we can improve this in future. (ticket#39)
3263
3264* (MacOS X version): If built with wxWidgets >= 3.1.0 (which is still in
3265  development), we now call EnableFullScreenView() which improves the full
3266  screen mode experience on OS X 10.7 and later.
3267
3268* img library: Improve documentation for img_ERROR_INFO.
3269
3270* tests/: Ship some missing .out files and compare.tst.
3271
3272* tests/: cavern.tst testcase back2 is now actually used.  Fix a bug in this
3273  testcase, and extend it to cover a variant of the situation reported as a bug
3274  in therion by Bill Gee to the therion list.
3275
3276* (Linux version) survex.spec: Add run-time requirement on proj and proj-epsg
3277  for the survex package and on tk for the svxedit package.
3278
3279Changes in 1.2.14 (2014-07-05):
3280
3281* img library: Add ability to store a PROJ4 string describing the coordinate
3282  system in use in 3d v8 files.
3283
3284* aven: If the 3d file specifies a coordinate system, then use it for exporting
3285  to formats which need to know (currently GPX).  If the input file doesn't
3286  specify the coordinate system, allow the user to enter a PROJ4 string in the
3287  export dialog.
3288
3289* aven: You can now quickly zoom to a particular area by holding down the
3290  "Shift" key and dragging with the left mouse button to create a rectangular
3291  "rubber band box" around the area you wish to zoom to.  If you release the
3292  "Shift" key while still dragging, the box is centred on the start point
3293  rather than having one corner there.
3294
3295* aven: Fix exporting of passage tubes in elevations and extended elevations
3296  - previously up and down were getting drawn across the page!
3297
3298* aven: Fix "Cancel" to work on the print/export dialog, broken by changes in
3299  1.2.13.  (Reported by Brian Clipstone)
3300
3301* aven: Fix the conditions on which the menu item "Cancel measuring line" is
3302  enabled - previously it was hard to actually cancel it via the menu.
3303  Reported by Hugh St Lawrence.
3304
3305* aven: Fix wx assertion failures when showing hit test debug view on platforms
3306  such as 64-bit Linux.
3307
3308* aven: When viewing from above, show "Plan" above the "clino" which indicates
3309  the tilt angle (instead of "Elevation -90°").
3310
3311* aven: The extended font data now loads faster, and also uses less memory on
3312  64-bit platforms.
3313
3314* aven: Dragging the vertical divider between the side panel and the 3D view
3315  now only updates when you finish the drag, as redrawing continuously just
3316  looks clunky except on an ultra-fast machine.
3317
3318* aven: (German translation) Abbreviate "Blickrichtung" so it doesn't overfill
3319  the space available in the aven UI.
3320
3321* cavern: Add a *cs command to allow setting the coordinate system for *fix
3322  commands, and the coordinate system used for processed survey data.  The
3323  latter is now stored in 3d v8 format files.
3324
3325* cavern: Add support for 'L' flag (exclude from length) in Compass .dat files
3326  and handle it in the same way as the "DUPLICATE" flag in .svx files.
3327
3328* cavern: If there's more than one *fix command with coordinates, still
3329  actually fix the second and subsequent ones, to avoid triggering bogus errors
3330  about unconnected surveys.
3331
3332* cavern: If there's more than one *fix command with coordinates, report the
3333  station name of the previous one, plus the file and line number where it was.
3334
3335* cavern: Fix handling of the rather contrived case of *fix with no coordinates
3336  followed by *solve and then another *fix with no coordinates not to access
3337  freed memory.
3338
3339* dump3d: Report any specified coordinate system.
3340
3341* doc/3dformat.htm: Update to document how the coordinate system is stored.
3342
3343* (Microsoft Windows version): Include dump3d in the installer.
3344
3345* Fix a compiler warning.
3346
3347* Improve test coverage.
3348
3349Changes in 1.2.13 (2014-05-15):
3350
3351* aven: Fix --print option to wait for printing to happen before exiting
3352  (previously it would exit right after opening the print dialog, so you
3353  couldn't actually print anything out using it).
3354
3355* aven: Increase the threshold for how close the pointer needs to be to a
3356  station from 5 pixels to 7 to try to help touchscreen users.  Reported by
3357  Hugh St Lawrence.
3358
3359* aven: Add "fat finger" mode, toggled by pressing F2, to allow investigating
3360  if increasing the minimum pointer to station threshold helps Hugh's problems
3361  with using aven on a touch screen device.
3362
3363* aven: The measuring line was unable to see stations which had just been
3364  revealed by toggling surface or underground legs on - this is now fixed.
3365
3366* aven: Add "hit test grid debug" mode, which shows the hit test grid and how
3367  many entries are in each box (toggled by F3).
3368
3369* aven: Pressing F4 now allows the user to toggle wxWidgets assertion messages
3370  off and back on.
3371
3372* aven: Create the empty hit-test grid data structure lazily, to reduce start
3373  up time a little.
3374
3375* cavern: Improve messages which talk about "tags" and/or "prefixes" in *begin
3376  and *end commands to instead talk about "survey names".
3377
3378* cavern: For ages cavern has warned if you reentered a survey, but this
3379  warning was suppressed if it occurred at the same line of the same file as
3380  the survey was first entered, but this can only happen if you include the
3381  same survey file more than once, which isn't a sensible thing to do for a
3382  file with actual survey data in (you might reasonably do it to set up survey
3383  grade details or something like that).  The warning is now given in this
3384  situation too.
3385
3386* cavern: After 5 warnings about reentering a survey we give up warning about
3387  it, but we used to keep reporting where the survey was originally entered -
3388  this secondary diagnostic message is now silenced when the main message is.
3389
3390* (Microsoft Windows version): Compile C code with optimisation on.
3391
3392* Add the start of a Russian translation, with messages take from therion.
3393
3394* Minor translation updates to French.
3395
3396* Fix compiler warning from GCC.
3397
3398* Testsuite improvements:
3399
3400  + Test that "..." anon station works.
3401
3402  + cavern.tst: Check number of errors returned by all testcases which should
3403    fail and give an error count.
3404
3405  + cavern.tst: Fix to actually fully test everything when builddir != srcdir.
3406
3407Changes in 1.2.12 (2014-04-14):
3408
3409* aven: Fix measuring line to show change in altitude rather than altitude
3410  itself (accidentally broken by changes in 1.2.11).  Reported by Brian
3411  Clipstone.
3412
3413* aven: Fix printing when built with wxWidgets 3.0.
3414
3415* aven: Several visual improvements to printouts:
3416
3417  + Move the numbers below the scale bar down a little so that they don't
3418    overlap the scale bar ticks.
3419
3420  + Set the clipping region after we draw the page border and info box to avoid
3421    clipping the border in print preview.
3422
3423  + Tidy up the appearance of the compass and elevation arrow.
3424
3425* aven: Fix to build with libav 10.  Reported by Moritz Muehlenhoff in
3426  <http://bugs.debian.org/739332>.
3427
3428* aven: Fix to build with older libav where avcodec_free_frame() isn't
3429  available.
3430
3431* (Linux version) survex.spec: Update spec file used for building RPM packages.
3432
3433* (Unix version): Add "Keywords:" entry to .desktop files.
3434
3435* (Unix version): Enable large file support, mostly to support filing systems
3436  which return 64 bit inode values, such as CIFS mounts.
3437
3438* (Microsoft Windows version): Only allow "A-Z" or "a-z" for driver letters,
3439  rather than any character which is a letter in the current locale.
3440
3441* Various translation updates.
3442
3443Changes in 1.2.11 (2014-01-28):
3444
3445* aven: Fix wxWidgets assertion when double clicking on an anonymous station.
3446  Reported by Kevin Dixon.
3447
3448* aven: Embed the font data for the first 256 Unicode characters for use in the
3449  survey pane into the compiled aven binary to reduce start up overhead.  Any
3450  additional characters needed are loaded from a data file only if/when a
3451  character >= U+100 is actually needed (as before).
3452
3453* aven: Fix display of Unicode characters above 256 when there's a character
3454  <= 256 earlier in the same string.
3455
3456* aven: Use the actual width of Unicode characters above 256 rather than
3457  assuming they are 16 pixels wide.
3458
3459* aven: If full screen, don't show the side panel when a new file is opened
3460  (e.g. via Ctrl+O).
3461
3462* aven: Don't give an assertion failure when showing passages for a cave with
3463  no vertical extent.  Reported by Jonny Prouty.
3464
3465* aven: Change terminology in print dialog - say "legend" instead of "info
3466  box".
3467
3468* aven: Add option to show the tilt angle as a percentage gradient.
3469
3470* aven: Show the units (degrees, grads, or percent) for the tilt and bearing
3471  indicators.
3472
3473* aven: All length units are now translatable.
3474
3475* aven: Split log_fl_error helper function out of CHECK_GL_ERROR macro, which
3476  will reduce code size and also the number of deprecation warnings about
3477  gluErrorString on Mac OS X 10.9.
3478
3479* (Microsoft Windows version): aven: Try to work around redraw issues related
3480  to the measuring line by redrawing the whole window, which doesn't seem to be
3481  measurably slower.
3482
3483* cavern: If *units is used to try to set units for LEVEL, PLUMB, or POSITION,
3484  give an error rather than quietly ignoring the attempt.
3485
3486* cad3d: Make cad3d remap control characters and spaces in station names when
3487  generating PLT output in the same way aven does.
3488
3489* Various translation updates (particular thanks to Eric Madelaine and Dennis
3490  Baudys), including the start of a Bulgarian translation, with messages taken
3491  from Therion and elsewhere.
3492
3493* (Microsoft Windows version): On Microsoft Windows 2000 and newer, use
3494  GetUserDefaultUILanguage() to get the UI language to use.  For older
3495  versions, continue to use GetUserDefaultLCID().
3496
3497* (Microsoft Windows version): The Indonesian translation will now be used
3498  automatically when the system language is set to Indonesian.
3499
3500* (Mac OS X version): Fix to build with wx 3.0.0 on OS X 10.9.  Thanks to David
3501  A. Riggs for his work on this.
3502
3503* (Mac OS X version): Update buildmacosx.sh script to use wx 3.0.0, and add a
3504  checksum check for the downloaded wx sources.
3505
3506* Fix a lot of the compiler warnings when building with clang.
3507
3508* doc/manual.sgml: Add missing quantities to the list documented as accepted by
3509  *units: LEFT, RIGHT, UP/CEILING, DOWN/FLOOR (missing entirely);
3510  BACKCOMPASS/BACKBEARING, BACKCLINO/BACKGRADIENT (missing from the main list,
3511  mentioned in list of the units that can be set for them); COUNT (missing
3512  alternative name for COUNTER); DX/EASTING, DY/NORTHING, DZ/ALTITUDE
3513  (incorrectly listed as X, Y, Z).  Reported by Jonny Prouty.
3514
3515* Test suite: Improve test coverage for cavern.
3516
3517Changes in 1.2.10 (2014-01-15):
3518
3519* aven: Fix assertion if two mouse buttons are held down at the same time.
3520  If dragging with more than one mouse button held down, releasing one causes
3521  another which is still held down to take effect.  Reported by Brian
3522  Clipstone.
3523
3524* aven: If we fail to start the external editor when the user clicks on an
3525  error or warning from cavern, show an error box.
3526
3527* aven: If the survey has a title, add it as a top-level <title> element to
3528  exported SVG files.
3529
3530* aven: Escape '<', '>', and '&' in labels in exported SVG files.
3531
3532* aven: In GPX export, set the <time> element to the datestamp from the 3d
3533  file.
3534
3535* aven: Don't try to write the title if it isn't set or is empty when exporting
3536  GPX files.
3537
3538* aven: Don't bother looking up the printer page setup info when exporting.
3539
3540* (Microsoft Windows version): aven: Fix crash on "File->Print" or
3541  "File->Export" under Windows XP, reported by Brian Clipstone.
3542
3543* (Microsoft Windows version): aven: Fix error dialog about an incorrectly
3544  encoded filename which could occur if run without being asked to load a file
3545  on startup.
3546
3547* (Microsoft Windows version): aven: Compile with optimisation on.
3548
3549* img library, aven: Although processed CMAP data files are often referred to
3550  as "CMAP .XYZ files", it seems that actually, the extension .XYZ isn't used,
3551  rather .SHT (shot variant, produced by CMAP v16 and later), .UNA (unadjusted)
3552  and .ADJ (adjusted) extensions are.  Since we've long checked for .XYZ, we
3553  continue to do so in case anyone is relying on it, but also check for the
3554  other extensions.
3555
3556* img library: Add new "datestamp_numeric" field to struct img giving the
3557  datestamp as a time_t in UTC (or (time_t)-1 if there's no datestamp or we
3558  failed to convert it).  For .3d >= v8, this field is reliable.  We attempt to
3559  convert date strings in .3d <= v7 and CMAP XYZ files, but may get the
3560  timezone wrong.
3561
3562* img library: Fix my_strcasecmp() to handle top-bit set characters better.
3563
3564* cavern: Fix NULL pointer dereference when processing Compass DAT file without
3565  'SURVEY DATE:'.
3566
3567* doc/manual.sgml: Update references to Survex 1.1 which should be to 1.2.
3568
3569* doc/manual.sgml: Note the station length limit Smaps used.
3570
3571* Fix some compiler warnings if built with glibc's fortify source feature
3572  enabled.
3573
3574Changes in 1.2.9 (2014-01-08):
3575
3576* Document --3d-version in cavern man page and the manual.
3577
3578* aven: Fix compilation error in movie export code with recent libavi.
3579
3580* aven: Fix warning on stderr when export a movie as MPEG.
3581
3582* img library: In non-hosted mode, don't define GETC and PUTC if they're
3583  already defined, to allow easy overriding with getc_unlocked() and
3584  putc_unlocked() (which are significantly faster on Linux).
3585
3586* img library: In non-hosted mode, check that int is at least 32 bits,
3587  and if not, use long.  In practice, platforms with 16 bit int are mostly
3588  obsolete, but it's not hard to be portable here.
3589
3590* img library: Add test that img.c and img.h compile in non-hosted mode
3591  (regression test for issue fixed in 1.2.8).
3592
3593* (Microsoft Windows version): aven is now built with wxWidgets 3.0.0.
3594
3595* Update translations from launchpad and from existing similar messages.
3596
3597* Fix some compiler warnings.
3598
3599Changes in 1.2.8 (2013-10-29):
3600
3601* cavern: Fix handling of anonymous wall stations ('..' by default) to
3602  implicitly set the SPLAY leg flag, as was intended.  Reported by Thomas
3603  Holder.
3604
3605* cavern: Tweak .err file output not to lose the space in front of certain
3606  statistics when the value gets large.
3607
3608* cavern: Eliminate redundant progress message when solving simultaneous
3609  equations.
3610
3611* aven: Add a format drop down to the export dialog, and only show fields which
3612  are meaningful and supported for the currently selected export format.  The
3613  format defaults to that used most recently.  The "Elements" and "View" boxes
3614  have been swapped in the print and export dialogs as that layout works much
3615  better when the "View" box is hidden.
3616
3617* aven: Changing checkboxes in the print or export dialog didn't work in 1.2.7
3618  - now works again.  Reported by Anthony Day.
3619
3620* aven: Add GPX export (based on findentrances patch from Olaf Kähler).  In
3621  this release the projection which the survey coordinates are in defaults
3622  to the BMN M31 grid used in the Totes Gebirge in Austria.  On Unix, you
3623  can edit ~/.aven and add a new line setting 'input_projection' to a PROJ
3624  projection string.  The ability to specify this projection in a better
3625  way is coming soon.
3626
3627* aven: New export options "Origin in centre" and "Full coordinates" - the
3628  latter fixes #10.  GPX and PLT output implicitly force "full coordinates".
3629
3630* aven: The "Sketch" vector drawing program got renamed to "Skencil" some
3631  time ago, so update references.
3632
3633* aven: Make the Presentation->Play menu item a checkbox, to avoid a warning
3634  with wxMSW 2.9.5.  Reported by Brian Clipstone.
3635
3636* aven: Make right click in an empty presentation mark the current position and
3637  open it to edit, instead of crashing.
3638
3639* aven: Update movie export code to work with latest libav API.  Reported by
3640  Sebastian Ramacher.
3641
3642* aven: Improve reporting of errors during the process of exporting a movie.
3643
3644* aven: Don't try to close the movie if we aren't producing one.
3645
3646* aven: Fix assertion failure when double-clicking on the survey with wx2.9.
3647
3648* aven: Fix to build with wxMSW 2.9.5.
3649
3650* aven: Fix to build with wx 2.9.5 with wx2.8 compatibility disabled.
3651
3652* cad3d: The "Sketch" vector drawing program got renamed to "Skencil" some time
3653  ago, so add a new --skencil option to specify this output format.  The old
3654  name (--sketch) is still recognised for compatibility.
3655
3656* cad3d: Make --marker-size work for Skencil and SVG output.
3657
3658* dump3d: Make --show-dates option show dates for XSECT.
3659
3660* img library:
3661
3662  + Fix to work once more when used outside of Survex (missing definition of
3663    max() macro and a bad call to free() in img_close() for a file opened for
3664    reading).
3665
3666  + Use lround() instead of round(), and make the tests around whether we use
3667    the library function or the our fallback implementation saner.
3668
3669  + Fix // comments in C code for portability to pre-C99 compilers which don't
3670    support these as an extension.
3671
3672  + Can now be compiled as C++ as well as as C.
3673
3674* (Microsoft Windows version): The installer is now built with a newer version
3675  of Innosetup, and includes translations for all the languages which Survex
3676  itself has any translations for.
3677
3678* (Microsoft Windows version): aven is now built with wxWidgets 2.9.5.
3679
3680* Minor translation updates.
3681
3682* tests/Makefile.am: Distribute files for "normal_bad" testcase.
3683
3684Changes in 1.2.7 (2013-07-27):
3685
3686* Add support for anonymous stations, which are indicated by one, two or three
3687  separator characters - with the default separator of '.', that means '.',
3688  '..', and '...' are anonymous stations.  Single separator ('.' by default)
3689  is an anonymous non-wall point, double separator ('..' by default)
3690  is an anonymous wall point at the end of an implicit splay), and triple
3691  separator ('...' by default) is an anonymous point (with nothing special about
3692  the leg).  A new *alias command allows '-' to be mapped to '..' for
3693  compatibility with pocket topo: *alias station - ..
3694
3695* New version 8 of the 3d format:
3696
3697  + Supports new flags img_SFLAG_ANON and img_SFLAG_WALL.
3698
3699  + New explicit file-wide flag for 'this is an extended elevation', rather
3700    than modifying the survey title to indicate this.
3701
3702  + The survey prefix is often unchanged from one leg to the next, so use a
3703    spare flag to compactly indicate when there's no label change.
3704
3705  + The data style of each leg is now stored.
3706
3707  + The "processed at" time is stored as seconds since 1970 rather than a
3708    human-readable string.
3709
3710  + Since 3d v8 features significant changes to the format, the format
3711    documentation for v7 and earlier has been split off into 3dformat-old.htm.
3712
3713* img library:
3714
3715  + New station flags img_SFLAG_ANON and img_SFLAG_WALL.
3716
3717  + Handle .pos files containing unnamed stations - don't suck the next line in
3718    as the station name, and set img_SFLAG_ANON for them.
3719
3720  + Repurpose the long unused fBinary parameter to img_open_write() as a flags
3721    parameter, and add img_FFLAG_EXTENDED to specify that this is an extended
3722    elevation, in place of appending " (extended)" to the title.  Internally we
3723    still append this to the title (and remove it upon reading) when writing
3724    3d v7 or earlier, but for the new 3d v8 format, this flag is stored
3725    explicitly in the file.
3726
3727  + img.h: Add comments for the lists of "Leg flags" and "Station flags".
3728
3729* aven:
3730
3731  + We now require at least wxWidgets 2.8.0 - it was released over 6 years ago
3732    now, and the wx developers consider even 2.8 to be rather long in the
3733    tooth.  We stopped testing building with wxWidgets 2.6 some time ago, and
3734    formally dropping support for older versions allows a number of workarounds
3735    to be removed from the aven source code.  Also, features deprecated in
3736    wxWidgets 2.9 are no longer used in our code.
3737
3738  + Don't run incremental search on every key-press, as on a slow machine the
3739    short initial search(es) will take a while but not be useful.  Instead only
3740    actually run the search when we're told there are no more key-presses
3741    queued up.
3742
3743  + Implement support for including cross-section information in exported SVG
3744    and DXF files (ticket#4).  The DXF export is untested currently.
3745
3746  + Show splay legs faded by default, with menu options to hide them or show
3747    them like other legs.
3748
3749  + Speed up loading a .3d file with cross-sections by using a map to convert
3750    station names to positions.
3751
3752  + In the cavern log window, don't highlight a file:linenumber if there's no
3753    message after it, which avoids highlighting the "Included from" lines
3754    wrongly.
3755
3756  + Fix not to crash when trying to report an error while starting up.
3757
3758  + (MacOS X version): Change the menu shortcut for "Full Screen Mode" to be
3759    the OS X standard shortcut Shift-Command-F (previously we used F11, but
3760    that's used by the desktop).
3761
3762  + Add checks for errors when reading the font file.
3763
3764  + Remove useless extra quoting when invoking vim to show the location of an
3765    error from cavern.
3766
3767  + Include GL/gl.h before GL/glext.h (needed on Debian wheezy).
3768
3769  + Use wxValidator to simplify keeping svxPrintDlg member variables and fields
3770    in the dialog in sync.
3771
3772* cavern:
3773
3774  + Demote errors about invalid dates to warnings, since we've accepted *date
3775    for ages without any checks on the value, and so existing datasets
3776    probably contain invalid dates and dates in other formats.  (ticket#19)
3777
3778  + New *alias command allows '-' to be mapped to '..' for compatibility with
3779    pocket topo: *alias station - ..
3780
3781  + We want to warn if there's a clino reading which it would be impossible to
3782    have read from the instrument (e.g. on a -90 to 90 degree scale you can't
3783    read "93" (it's probably a typo e.g. for "39").  However, the gradient
3784    reading from a topofil is typically in the range 0 to 180, with 90 being
3785    horizontal.  Really we should allow the valid range to be explicitly
3786    specified, but for now we infer it from the zero error - if this is within
3787    45 degrees of 90 then we assume the instrument can read between 0 and 180
3788    degrees.
3789
3790  + If the survey isn't all connected, still run survey tree checks and report
3791    errors and/or warnings which might suggest typo locations.  Thanks to Kevin
3792    Dixon for the report which highlighted this issue.
3793
3794  + Report a warning if *begin SURVEY has a separator character in SURVEY.
3795
3796  + Report column numbers as well as line numbers for some cavern errors and
3797    warnings.
3798
3799  + Adjust width of node stats table to fit longest count when there are more
3800    than 9999 of a particular order of node.
3801
3802  + If the argument to *include has an opening double quote but the closing
3803    double quote is missing, then skip trying to open the file.
3804
3805  + Move "Station X referred to just once" warning after non-existent survey
3806    check - if both fire, the non-existent survey error is likely to be more
3807    relevant.
3808
3809  + We no longer follow an error for a bad reading in passage data with a bogus
3810    "End of line not blank" error, but instead check the remaining readings on
3811    the same line.
3812
3813  + We no longer follow an error about OMIT for a required reading with a bogus
3814    "End of line not blank" error.
3815
3816  + Report an error if the scale factor in *calibrate is zero - it doesn't make
3817    sense and probably means someone reversed the arguments to *calibrate.
3818
3819  + Report the parent include files starting from the outermost, as that's more
3820    logical when there are multiple levels involved.
3821
3822  + If we were expecting a numeric field and instead get something which starts
3823    with '+', '-', or '.' but which isn't a number, then fix the error to
3824    include that character in the token reported.
3825
3826  + Simplify handling of quantity lists to only recognise 'DEFAULT' as the
3827    first item.
3828
3829* cad3d: Check for errors from img_rewind() and report them.
3830
3831* dump3d:
3832
3833  + Build, install and package dump3d as standard - it's useful for grabbing
3834    info from 3d files in scripts.
3835
3836  + Add --show-dates option.
3837
3838  + Show only 2 decimal places on coordinates and passage dimensions.
3839
3840  + Report the data style of legs.
3841
3842  + Report if the file is an extended elevation.
3843
3844  + Report img_STOP as STOP rather than CODE_0xffffffff.
3845
3846* Test suite:
3847
3848  + cavern.tst: Fix equatenosuchstn testcase (added in 1.2.6) to normalise the
3849    expected output so it passes reliably.
3850
3851  + cavern.tst: Run diffpos <expected> <actual> so the reports of 'Added' and
3852    'Deleted' stations upon failure are the more natural way round.
3853
3854  + Add more testcases, expand some existing testcases, and add expected output
3855    for more.
3856
3857* (Microsoft Windows version): Use wx-config's --cc and --cxx flags to find the
3858  appropriate C and C++ compilers to use, and link mingw build statically to
3859  avoid needing the libgcc DLL (which newer GCC seems to have by default).
3860
3861* (Unix version): When determining the character set for command-line tools,
3862  check environmental variable LANG after LC_ALL and LC_CTYPE.
3863
3864* When determining the language, check environmental variable LC_ALL before
3865  LC_MESSAGES and LANG (but after SURVEXLANG).
3866
3867* If we don't find the message file, only give an error if it was specified
3868  with SURVEXLANG, since that is an explicit instruction to Survex, whereas
3869  LANG, LC_ALL and LC_MESSAGES are essentially system "preferred locale"
3870  settings.
3871
3872* There are a handful of hard-coded English message strings for reporting
3873  errors trying loading message files, etc.  These are all now ASCII, as if we
3874  fail trying to open a message file, it's more likely the encoding isn't
3875  set correctly.
3876
3877* Prune strings we are no longer using and are probably unlikely to use again
3878  into a new file po_codes_dead, so that translators don't get presented with
3879  them to translate.
3880
3881* Merge lots of translation updates.  Most translations are now complete or
3882  close to complete.
3883
3884* Add start of Indonesian translation from Arief Setiadi Wibowo.
3885
3886* Fix various compiler warnings when building from source.
3887
3888* Include scripts gdtconvert and gen_img2aven in the source distribution.
3889
3890Changes in 1.2.6 (2012-02-23):
3891
3892* (Mac OS X version): Fix so that cavern finds its messages when run by aven.
3893
3894* (Microsoft Windows version): Include JPEG images for aven in the installer
3895  package (ticket#35).
3896
3897* cavern: If we have a reference to a station in a non-existent survey, give a
3898  helpful error rather than saying the station hasn't been exported from the
3899  survey.  (Bug reported by Martin Green via email)
3900
3901* aven: Fix to build with a non-Unicode wxWidgets library.  Patch from Olaf
3902  Kahler.
3903
3904* findentrances: Add findentrances utility from Olaf Kahler which produces a
3905  .gpx file with waypoints for entrances.  This needs libproj so is disabled
3906  by default for this release - to enable it install the development stuff for
3907  libproj and build survex with:
3908
3909      make FINDENTRANCES=findentrances
3910      make install FINDENTRANCES=findentrances
3911
3912* dump3d: Add support for showing img_ERROR_INFO items.
3913
3914* doc/3dformat.htm: Merge in some improvements from Mike McCombe.
3915
3916* Incorporate a French translation from launchpad I'd previously copied the
3917  English version of by mistake.  Attempt to correct mistranslation of "survey
3918  file".
3919
3920Changes in 1.2.5 (2012-01-03):
3921
3922* aven:
3923
3924  + The survey tree in the left panel is now in sorted order once more.
3925
3926  + No longer fails with an assertion if used for a long time (we were leaking
3927    an OpenGL list each time one had to be regenerated).
3928
3929  + Now builds with newer FFmpeg library.
3930
3931  + Draw measuring line in front of the indicators rather than behind them.
3932
3933  + Loading a new file (or reloading the current one) no longer invalidates
3934    the OpenGL lists for the compass and clino, so will be a fraction faster.
3935
3936* Improve handling of attempts to look up translated messages before the
3937  message subsystem is fully initialised (which only happens if there's an
3938  error early on).
3939
3940* Improve the survex(7) man page text, and fix it to be marked as section 7 in
3941  the man page source as well as in the filename.
3942
3943Changes in 1.2.4 (2012-01-01):
3944
3945* aven:
3946
3947  + A change in 1.2.3 meant that aven tried to use OpenGL before it was
3948    initialised, which doesn't cause problems in some machines, but causes aven
3949    to abort on others.  This is now fixed, and there's a check in place to
3950    help avoid similar issues in future. (ticket#34)
3951
3952  + Always use metres or feet for the depth colour key, and choose a consistent
3953    precision by looking at the depth range. (ticket#30)
3954
3955  + Show the depth units below the colour bar rather than after every value.
3956
3957  + When zooming way in, stay in metres rather than switching to cm.
3958
3959  + On the scale bar, say “1 mile” rather than “1 miles”.
3960
3961* Translation updates for Catalan, French and Slovak.
3962
3963Changes in 1.2.3 (2011-12-31):
3964
3965* Fix to build with wxWidgets 2.9.2.
3966
3967* (Mac OS X version):
3968
3969  + Processing .svx files from aven now works.
3970
3971  + Remove spurious blank lines from the licence text in "Get Info".
3972
3973  + Don't create the help menu at all, as it is empty (because the "About"
3974    entry goes elsewhere) and sometimes seems to appear in the UI.
3975
3976  + INSTALL.OSX: Update to reflect current status.
3977
3978* aven:
3979
3980  + Fix Y coordinates of surface surveys on printouts.  (Closes #32)
3981
3982  + Improvements to text plotted on the survey pane:
3983
3984    - Support plotting Unicode character points > 256 by lazily loading the
3985      data for them from the font file and plotting them with a direct call to
3986      glBitmap(), which is slower but doesn't require a display list per
3987      character.
3988
3989    - Adjust the spacing from fixed width to putting a one pixel gap either
3990      side of each one character (so two between adjacent glyphs).  Mostly this
3991      reduces the horizontal width, but it adds a pixel for characters like "m"
3992      and two in a few cases.
3993
3994    - Fix .pixelfont file generation to correctly handle characters wider than
3995      8 pixels.
3996
3997  + Fix expected cross shape so don't always reject using texture mapping to
3998    draw crosses.
3999
4000  + As we read a survey file, eliminate tubes consisting of zero XSECTs as well
4001    as those consisting of just one.  Previously we would trip over the empty
4002    tube later.  Such tubes can for example be created by extend if a splay shot
4003    is the start or end of a tube.
4004
4005  + Make the green colour used for entrances in the survey tree the same
4006    (slightly darker than before) green used for the entrance blobs.
4007
4008  + Report the version of the library we're actually running with if built
4009    against wx >= 2.9.2.  Make it clear that the version reported is the
4010    version *built* with for wx < 2.9.2.
4011
4012* extend:
4013
4014  + Copy the end markers for passage tubes.
4015
4016  + Preserve left and right data for tubes (previously they were set to -1.0
4017    which means "no info").
4018
4019* img library: Fix incorrect comment in img.h which claimed that img_XFLAG_END
4020  was no longer used - it certainly is!
4021
4022* Use curly double quotes instead of "`" and "'" to quote filenames, etc in
4023  messages, and curly single right quote instead of straight ASCII apostrophe.
4024  Fall back to using straight ASCII versions if we can't represent them in the
4025  current character set.
4026
4027* Translation updates for Catalan, French, Slovak and Spanish.
4028
4029* Test suite:
4030
4031  + Add test coverage for interleaved diving data.
4032
4033  + Add testcase for diving data with topofil-style distance.
4034
4035Changes in 1.2.2 (2011-10-06):
4036
4037* aven:
4038
4039  + Replace the textured-mapped font drawing with an approach based on
4040    glBitmap.  This doesn't suffer from the character alignment issues which
4041    the textured-mapped fonts had, and is actually significantly faster on some
4042    machines.  The current font used is (mostly) fixed-width, but this isn't an
4043    inherent limitation - it was just the easiest font data to convert to a
4044    usable format.
4045
4046  + Fix assertion failure due to rounding differences on loading certain .3d
4047    files.  (ticket#26)
4048
4049  + Fix assertion failure when turning on 3D passages if they stick out higher
4050    or lower than any station.  (ticket#29)
4051
4052  + Fix grid not to disappear when blobs are turned on and blobs are drawn
4053    using lines.
4054
4055  + If a degree sign isn't available in the character set in use, transliterate
4056    it to 'dg' rather than skipping it.
4057
4058  + Fix message which should have been a degree sign but got lost in the format
4059    change for 1.2.0 and then got reassigned in 1.2.1.  Externally, this means
4060    that bearings in the status bar now have a degree sign after them if they
4061    are in degrees rather than nothing (1.2.0) or "&Hide Compass" (1.2.1).
4062
4063  + Fix print dialog to calculate the scale required for "One page" right
4064    before it calculates how many pages are required, so we don't end up
4065    something other than 1x1 being shown when the user changes settings.
4066
4067  + Update the calculations for picking a scale and for deciding how many
4068    pages are needed to take into account the change in info box height made
4069    in 1.2.1.
4070
4071Changes in 1.2.1 (2011-10-04):
4072
4073* Translation updates for US English.
4074
4075* aven:
4076
4077  + Rename the "depth bar" to "colour key" in documentation, menus, etc since
4078    it now shows colours for dates and errors as well as depths.
4079
4080  + In the colour key for "colour by date", change "No info" to "Undated".
4081
4082  + Remove the dark grey background from the colour key and just put a single
4083    pixel black border around the colours.  This is more in keeping with the
4084    other controls, and means the colours are now on a black background so more
4085    visually similar to the survey legs.
4086
4087  + Move the colour key's "Undated"/"Not in loop" entry down a little to
4088    improve the appearance.  Make each section a pixel taller.
4089
4090  + Allow "Colour by X" to be selected even if there's no data for X or only a
4091    single value of X used (the colour key is much smaller in these cases, and
4092    does still provide some useful information).
4093
4094  + Fix incorrect calculation of depth colouring for survey legs which straddle
4095    a depth band boundary.
4096
4097  + The scale bar, compass, clino, and colour key now all have right click
4098    menus which allow related actions to be performed (especially handy in
4099    full-screen mode).
4100
4101  + Improve the font used on the survey pane - it now contains the '-'
4102    character (so the clino now shows negative angles as negative, and dates
4103    in the colour key are now hyphenated).  Also the spacing and alignment
4104    are a little better, though still not perfect.
4105
4106  + PLT file export now handles spaces and control characters in station names
4107    by escaping them with '%' as in URLs.
4108
4109  + Pressing "Enter" on a station in the tree control now centres the view on
4110    that station.
4111
4112  + The scale bar is now cached in an OpenGL display list since it often gets
4113    redrawn exactly the same - for example, when rotating, panning, etc.
4114
4115  + Pressing "F5" forces all cached OpenGL drawing lists to be invalidated and
4116    then forces a refresh of the survey pane.  This is intended as a debugging
4117    aid - if pressing F5 changes the display at all then there's a missing case
4118    where a list should have been invalidated (please report if you find such
4119    a case as it is a bug).
4120
4121  + We now automatically track which OpenGL display lists need to be
4122    invalidated on window width or height changes.
4123
4124  + Increase scale bar maximum width from 65% of the window width to 75% as it
4125    was in 1.0.x (except that if that would overlap the clino we now reduce
4126    that proportion down until it reaches 50%).  Make the limit of zooming in
4127    the same as in 1.0.x.  (ticket#23)
4128
4129  + (Linux version): Previously wxGTK didn't really handle showing a dialog if
4130    the application was fullscreen (the dialog got opened under the main
4131    window!)  To work around this, aven would switch out of full screen mode
4132    temporarily while showing a dialog.  This case works properly with recent
4133    wxGTK, so disable our workaround with versions we know work.  Also, apply
4134    the workaround only for wxGTK, not everywhere except on Microsoft Windows
4135    as there's no reason to think we need it for other platforms.
4136
4137  + Grey out the "View North" action when we're already viewing North, and
4138    similarly for other compass points.
4139
4140  + (Mac OS X and Microsoft Windows versions): Fix missing newline to OpenGL
4141    info in the "About" dialog.
4142
4143  + Fix to set the correct filename on the root of the survey tree - previously
4144    the filename of the previous file loaded was used!
4145
4146  + The movie export code now works with newer versions of the FFmpeg libraries
4147    as well as still working with older versions.
4148
4149  + Fix mixed up messages - the print dialog now says "View" on the left
4150    subgroup of controls rather than some unrelated message.
4151
4152  + On printouts, combine the "Plan View"/"Elevation" info box field with the
4153    field which gives the bearing and reduce the height on the info box by the
4154    removed field, so it's now 3cm for plans and elevations, as for extended
4155    elevations.  Report the tilt angle for tilted elevations which it seems has
4156    been missing for ages (it's not in recent 1.0.x either).
4157
4158  + Tweak the exact positioning of informational text on printouts to look
4159    nicer and make better use of the available space.
4160
4161  + Add keyboard mnemonics to the "Plan" and "Elevation" buttons in the print
4162    dialog.
4163
4164  + Make the sign of the tilt angle for printouts consistent with the sign
4165    shown by the "clino" in the survey pane.
4166
4167  + In the "Print" dialog, when in plan view disable the "Plan view" button,
4168    and similarly for the "Elevation" button.
4169
4170  + (Microsoft Windows version): Sort out appearance of custom cursors.
4171
4172  + If a label isn't valid UTF-8 or CP1252, fall back to ISO8859-1.
4173
4174  + (Mac OS X version): F11 puts aven into full screen mode, but apparently
4175    you can't get out again easily, so add code to explicitly check for F11
4176    being pressed and toggle full screen.
4177
4178* (Linux version): Fix the RPM .spec file for where man pages now get installed
4179  and package aven.svg and the vim support files.  (Fixes from James Begley)
4180
4181* "make check" now performs several checks on the translation files.
4182
4183* More messages are now available to be translated.
4184
4185* cavern: Fix reporting of ranges of survey coordinates, which was broken by
4186  the message handling changes in 1.2.0.
4187
4188* Fix warning when compiling with GCC.
4189
4190* INSTALL: Mention building wxWidgets with --enable-unicode.  Mention using
4191  sudo for installing on Unix.
4192
4193* In the manual, replace the instructions for building from source with a
4194  pointer to the clearer instructions in INSTALL.
4195
4196* In the manual, make it clear that installing with administrator rights
4197  also applies to newer platforms than XP.
4198
4199* doc/TODO.htm: Update.
4200
4201Changes in 1.2.0 (2011-09-20):
4202
4203* Translation updates for Catalan, French, Romanian, Spanish, Slovak, and US
4204  English.
4205
4206* tests/smoke.tst: aven no longer requires an X display for --help or
4207  --version, so replace skip of this check with a check that this remains the
4208  case.
4209
4210* We now use the standard .po and .pot file formats for storing translations
4211  (rather than the Survex-specific messages.txt format), and then translate
4212  these into Survex's .msg format.
4213
4214* (Unix version): Move survex man page to section 7 (since it isn't documenting
4215  an actual command).
4216
4217* (Unix version): Write each generated man page to a temporary file, then
4218  atomically rename, to avoid leaving an empty or partial man page behind if
4219  docbook-to-man dies (1.1.16 had an empty cad3d.1, and we want to avoid a
4220  recurrence of that).
4221
4222* (Unix version): Default to installing docs into /usr/share/doc/survex rather
4223  than /usr/doc/survex.
4224
4225* aven:
4226
4227  + Fix handling of accented characters in the survey pane.
4228
4229  + Aven icon redrawn in SVG format - it's now a vector image which looks
4230    nicer at larger sizes.
4231
4232  + Explicitly request double-buffering, which seems to be needed for systems
4233    with GLX >= 1.3.
4234
4235  + Fix crash while trying to load certain .3d files.
4236
4237  + Movie export code updated to work with more recent versions of FFmpeg.
4238    Currently this is disabled in Microsoft Windows builds, pending getting the
4239    required libraries set up for building releases.
4240
4241  + Reporting of errors during movie export improved.
4242
4243  + Force playback speed to "x1" during movie export.
4244
4245  + Use stock IDs for buttons where appropriate - such buttons may now be
4246    rendered with icons on some platforms.
4247
4248  + If a label isn't valid UTF-8, treat it as CP1252 (the Microsoft superset of
4249    ISO8859-1).
4250
4251  + (Unix version): Remove special handling for toggling "full screen" on wxGTK
4252    as it's no longer required with modern versions.
4253
4254  + Don't redraw the survey on every mouse movement in the survey pane unless
4255    the measuring line is (or just was) active.  (ticket #17)
4256
4257* cavern:
4258
4259  + Drop "non-fatal" from the report of how many errors there were at the end
4260    of the run - it just confuses users - we won't even get here if there's a
4261    fatal error!
4262
4263  + Add --3d-version option to allow the user to specify the version of the 3d
4264    format to output.  (ticket#21)
4265
4266* img library:
4267
4268  + Make the highest and lowest valid values for img_output_version available
4269    in img.h as IMG_VERSION_MIN and IMG_VERSION_MAX.
4270
4271* (Mac OS X version): Fix buildmacosx.sh script to check where the temporary
4272  volume actually gets mounted.  Fix URL for downloading wxWidgets.
4273
4274Changes in 1.1.16 (2011-05-16):
4275
4276* Translation updates for German, Spanish, Italian, Portuguese, Brazilian
4277  Portuguese, and US English.
4278
4279* Use horizontal ellipses character rather than '...' and right arrow character
4280  rather than '->' where these characters are available.
4281
4282* (Unix version): Link with -lGL, if it exists, to support linking with gold or
4283  GNU ld --as-needed (Debian bug #615781).
4284
4285* img.c:
4286
4287  + Fix code typo for IMG_API_VERSION == 0 case.
4288
4289  + Fix code typo in code used when IMG_HOSTED isn't defined.
4290
4291* doc/TODO.htm: Remove entries which have now been done.
4292
4293* (Microsoft Windows version): aven: We now include all the available
4294  translations for messages from wxWidgets, which means that standard widgets
4295  will appear translated where available even if Survex messages aren't
4296  translated.
4297
4298Changes in 1.1.15 (2010-10-15):
4299
4300* aven:
4301
4302  + In the cavern log window, change the "Rerun" button to "Reprocess" to
4303    follow terminology in manual and elsewhere.  Fixes ticket#15.
4304
4305  + When displaying output from cavern, don't update the window after every
4306    line, but only when we don't have data from cavern pending.  Hopefully
4307    addresses ticket#12.
4308
4309  + If we aren't using GL_POINTS for blobs, draw them using a series of
4310    abutting lines rather than with gluDisk which is faster and gives a
4311    consistent shape.
4312
4313  + Check whether blobs and crosses actually render correctly as points/point
4314    sprites, and if they don't, fall back to drawing them with lines.  The
4315    best method is cached on disk, and rechecked automatically if the graphics
4316    hardware is changed or the drivers upgraded.
4317
4318  + Fix non-USE_FNT case to work again (it's limited to ISO-8859-1 characters
4319    though, so we still enable USE_FNT by default).
4320
4321  + Don't offer "All files" wildcard in presentation save dialog.
4322
4323  + (Microsoft Windows): Handle filenames with non-Latin1 characters in in
4324    more places.
4325
4326  + (Microsoft Windows): Quote filenames with spaces and metacharacters in
4327    when running cavern from aven.  Fixes ticket#11.
4328
4329* editwrap: (Microsoft Windows): Handle filenames with non-Latin1 characters.
4330
4331* diffpos: Handle files with duplicate labels in better - extend generates
4332  duplicate labels when it breaks a loop.
4333
4334* Enable eswap-break testcase now that diffpos handles duplicate station names.
4335
4336* New v7 of .3d format which stores survey dates as number of days since
4337  January 1st 1900, so we now support dates from 1900-2078 (rather than
4338  1970-2037) with a smaller file size.  The img API is now versioned - you
4339  can select the new "version 1" by compiling with -DIMG_API_VERSION=1, which
4340  gives the survey dates in days in days1 and days2 instead of as time_t
4341  values in date1 and date2.  Fixes ticket#14.
4342
4343* Consistently use http://survex.com/ rather than http://www.survex.com/ - the
4344  former has been the canonical name for some time, with www.survex.com just
4345  redirecting to it.
4346
4347* (Unix version): Use unlocked file I/O if available, which can be much faster
4348  in some cases (we don't need the locking as we don't do multithreaded file
4349  I/O).
4350
4351* (Mac version): Fix compilation failure due to clash with Point in Mac OS X
4352  headers.
4353
4354* (Mac version): buildmacosx.sh now works again.
4355
4356* Most tests weren't actually running any testcases (looks like a sh
4357  portability issue).  This is now fixed, and fortunately all tests still pass.
4358
4359* Include the extra .isl translation files for Innosetup in the source archive.
4360
4361Changes in 1.1.14 (2010-07-26):
4362
4363* Restore compatibility with wxWidgets 2.6 (1.1.13 required wxWidgets 2.8).
4364
4365* aven:
4366
4367  + After processing survey data, if there were warnings or errors, add a
4368    "Rerun" button to allow easy reprocessing after fixing problems.  If there
4369    were only warnings, also add an "OK" button to allow moving on to viewing
4370    the processed survey data (fixes ticket#13).
4371
4372  + Optimise updating of the cavern log window (hopefully fixes ticket#12).
4373
4374  + Fix links in cavern log window to link from exactly '<file>:<line>' (and
4375    not the ': ' after), and to make the title for the terminal the
4376    warning/error message.  Avoid false positives by checking that '<line>' is
4377    a number.
4378
4379  + Don't double escape the contents of href and target in links in the cavern
4380    log window.
4381
4382  + Improve handling of the splitter window, fixing behavioural glitches in
4383    various cases.
4384
4385  + Highlight stations matching any current search when a file is loaded.
4386    (ticket#9)
4387
4388  + (Mac version): Fix build issue due to Mac OS X polluting the global
4389    namespace with its own "Point" class.
4390
4391  + (Unix version): The Gnome print dialog has its own preview window so
4392    suppress ours if using the Gnome one.
4393
4394  + (Unix version): Link aven with -lGLU which SuSE Linux needs.
4395
4396  + (Microsoft Windows version): Fix handling of a double-click on the survey
4397    tree when built with wxWidgets >= 2.8.11.
4398
4399* cavern: Report relevant file and line number for three warnings which didn't
4400  give them before.
4401
4402* (Unix and Mac versions): configure: Update the wx-config probing code -
4403  wxmac-config etc aren't present with newer wxWidgets versions so there's no
4404  point looking for them now.
4405
4406* (Mac version): buildmacosx.sh: This script builds a diskimage with Survex in
4407  for easy installation.  Update it to work with the latest Survex versions
4408  (use WX_CONFIG not WXCONFIG; use a Unicode build of wxWidgets; if building a
4409  private wxWidgets, use 2.8.11 not 2.7.0-1).
4410
4411* manual:
4412
4413  + Correctly capitalise "GTK".
4414
4415  + Note that on Linux we only regularly test builds with the GTK+ version
4416    (change taken from 1.0).
4417
4418* Fixed the cad3d man page, which was an empty file in 1.1.13.
4419
4420Changes in 1.1.13 (2010-06-16):
4421
4422* Say "wxWidgets" instead of "wxWindows" consistently.
4423
4424* img.c: Fix small memory leak (filename_opened member).
4425
4426* cad3d, aven: Fix export to SVG when a label contains a '%' character.
4427
4428* aven:
4429
4430  + wxWidgets 2.6.0 or newer is now required.
4431
4432  + A "Unicode" build of wxWidgets is now supported.  An "ANSI" build may still
4433    work but hasn't been tested recently (all packaged versions of wxWidgets
4434    seem to be Unicode now).
4435
4436  + Fix potential uses of uninitialised variables which may have been causing
4437    occasional glitches when loading a file on start-up.
4438
4439  + Improvements to the handling of the font used for plotting labels and other
4440    text on the survey pane:
4441
4442    - Loading the font file is more efficient.
4443
4444    - Character spacing is improved.
4445
4446    - Default font is now anti-aliased.
4447
4448  + "About" dialog:
4449
4450    - Add "Copy" button to copy the system info to the clipboard for easier
4451      bug reporting.
4452
4453    - List OpenGL extensions last, since there are usually lots of them with a
4454      modern gfx card.
4455
4456    - Fix 100% CPU usage while the "About" dialog is open.
4457
4458  + Processing .svx files:
4459
4460    - Passing a .svx file on the command line now works better.
4461
4462    - Put the survey data log window in a splitter in the usual frame rather
4463      than opening a separate frame for it.
4464
4465    - Auto-scroll the log window until we've reported a warning or error.
4466
4467    - Fix small memory leak.
4468
4469  + The presentation filename now defaults to using the basename of the
4470    currently loaded dataset, but we always prompt before we first save with
4471    such a name.
4472
4473  + Reduce memory usage when saving a screenshot.
4474
4475  + Allow "Toggle Fullscreen" to work even if no survey is loaded now that we
4476    persist the window size (and maximised or fullscreen state) between
4477    invocations.
4478
4479  + Fix reporting of OpenGL errors.
4480
4481  + Fix glitches when tilting while looking East.
4482
4483  + Added Portuguese and Slovak translations of wxWidgets messages.
4484
4485* Documentation:
4486
4487  + Rationalise manual formats - replace PostScript with PDF and drop RTF.
4488
4489  + Drop the "alternative manual formats" self-extracting zip file - people
4490    will generally just want one of the formats, so downloading several
4491    together isn't very useful.
4492
4493  + 3dformat.htm: Update for v6 format (thanks to Mike McCombe).
4494
4495  + GPL.htm: Replace HTML version of licence with a link to the version on
4496    the FSF website.
4497
4498  + ChngeLog.htm: Stop generating an HTML version of the ChangeLog - it's too
4499    low level to be of interest to non-developers, and developers can look at
4500    the source code.
4501
4502* (Unix version): configure: New preferred name for specifying wx-config script
4503  is WX_CONFIG.  WXCONFIG still supported for compatibility.
4504
4505* (Linux version): Source RPM package dropped as you can just build an RPM
4506  package from the source tarball.
4507
4508* (Microsoft Windows version): The installer is now created with a newer
4509  version of InnoSetup, which gives a 10% smaller download.
4510
4511Changes in 1.1.12 (2007-02-07):
4512
4513* aven:
4514
4515  + Remember the window size or maximised/fullscreen state between invocations.
4516
4517  + Add options dialog to "Export" similar to the one for "Print".
4518
4519  + The "number of pages required" in the print dialog now updates when you
4520    change what is to be shown (underground legs/surface legs/station
4521    names/crosses).
4522
4523Changes in 1.1.11 (2006-11-25):
4524
4525* Updated Czech, Spanish, and Slovak translations.
4526
4527* (MacOS X version): Assorted OS X specific tweaks and fixes.
4528
4529* aven:
4530
4531  + Pick a smaller and clearer font for labels.
4532
4533  + Fix character spacing.
4534
4535  + Tweak display of bearing and elevation angles to look nicer with
4536    proportional fonts.
4537
4538  + Use the title from the 3d (or plt, etc) file for the window title
4539    rather than the filename.
4540
4541  + Show distances to 2 decimal places rather than the nearest integer.
4542
4543  + Only consider underground legs when calculating the depth bands and
4544    depth colouring.
4545
4546  + Add "Colour by Error".
4547
4548  + Add entry for "white" in date and error keys.
4549
4550  + When setting the view to a single point, don't change the scale.
4551
4552  + If reloading the same file, don't change the view
4553
4554  + Fix filetypes selector in open dialog.
4555
4556  + Fix the charset we use for aven in certain cases.
4557
4558  + Call msg_init before using msg_lang or it won't ever be set!
4559
4560  + Pass wx the full language code to initialise the C library locale.
4561
4562  + Fix bug in generating prefix tree view which could lead to a bogus
4563    leading dot on some survey names (bug probably introduced in 1.1.10).
4564
4565  + "New Presentation" now ensures that the side panel is open
4566
4567  + Fix updating of cached opengl lists when the view is reset to the
4568    default.
4569
4570* Ignore LANG if it starts with a digit to avoid problems with bogus value for
4571  LANG which AutoCAD installation seems to set on MS Windows.
4572
4573* (Unix version): configure: Allow SGMLTOOLS and DOCBOOK_TO_MAN to be
4574  specified.  Either/both can be set to ":".
4575
4576* dump3d: Report unknown (to dump3d) codes returned by img.
4577
4578* img library: Flag all stations as underground in the old "ASCII" .3d format.
4579
4580Changes in 1.1.10 (2006-07-14):
4581
4582* aven: Clicking on a survey name in the survey tree now highlights it in
4583  the map view.  Double-clicking zooms the view to show the clicked survey
4584  highlighted.  Clicking the root clears the highlighting and double-clicking
4585  the root restores the default view.  To expand/collapse a branch, click
4586  on the "[+]" or "[-]" icon to the left of the survey name.
4587
4588* aven: The measuring line can now measure to anywhere in plan or elevation
4589  view (not just to a station!)  In plan view the horizontal distance and
4590  bearing are shown, while in elevation view the vertical distance is shown.
4591
4592* aven: Moving the mouse over a station in the survey view now highlights
4593  that station in the survey tree (though it may not be visible if the
4594  survey(s) it is in aren't expanded).
4595
4596* aven: Clicking on a station to centre the view now moves the mouse pointer
4597  to the new location of the station (except on Mac OS X where this isn't
4598  allowed).
4599
4600* aven: Fix which presentation toolbar buttons are shown as depressed.
4601
4602* Fix infinite loop reading 3d files with LRUD data (bug introduced in 1.1.9).
4603
4604* vim files are now installed with the correct paths (bug introduced in 1.1.9).
4605
4606Changes in 1.1.9 (2006-07-04):
4607
4608* (Unix version): Install desktop files for aven and svxedit contributed to the
4609  Ubuntu package by Phil Bull, and corresponding pixmaps.
4610
4611* Fix img to filter out cross-sections which don't match the subsurvey (if
4612  specified).  The API now returns img_XSECT_END to mark the end of a
4613  passage rather than setting a flag on the last img_XSECT of the passage.
4614
4615* Enhance integration with the vim editor - this can now colour .err files, run
4616  cavern from vim and parse error output, and run aven from vim.  Tweak the
4617  existing vim mode for .svx files to fix a few minor bugs and add support for
4618  the new "*data passage" style.
4619
4620* aven: fix drawing of the "blob" end of the measuring line on graphics cards
4621  which can't draw large enough blobs for us.
4622
4623* aven: sort out confusion about what encoding everything is in which means
4624  that the distance measured by the measuring line actually gets displayed
4625  and also fixes problems with empty menu items in non-English locales in
4626  some cases.
4627
4628* aven: redraw grey background after a menu is closed over the aven window
4629  with no survey loaded.
4630
4631* aven: fix bug which caused printing to crash (introduced in 1.1.8).
4632
4633* aven: avoid crash on some machines when opening "About" dialog before having
4634  loaded a survey.
4635
4636* aven: Translate "Plan" and "Elevation" buttons in print view dialog.
4637
4638* (Unix version): aven: Fix character set handling of cavern output.
4639
4640* cavern: Report an error if a cross-section is specified for a station which
4641  doesn't exist.
4642
4643* Updated French and Italian translations.
4644
4645* (Unix version): aven: Fix "Can't open message file `en_US' using path
4646  `${prefix}/share/survex'" error.
4647
4648* Fix bug in 3d file reading on 64 bit platforms when used in STANDALONE mode
4649  (doesn't affect Survex itself, but other applications which use img.c should
4650  update their copy).
4651
4652* (Unix version): Add checks that wxWidgets is a non-unicode version (wx 2.6
4653  and later are caught by configure, whereas older wx versions are caught when
4654  trying to compile).
4655
4656Changes in 1.1.8 (2006.06.30):
4657
4658* Drop support for building with wxWidgets versions prior to 2.4.0
4659  (which was released on 2003-01-07).
4660
4661* aven: Printing through aven now uses settings from the "[aven]" section
4662  of print.ini, and support for hierarchical sections (using "like=")
4663  has been disabled.
4664
4665* aven: Change mouse actions to be compatible with those in Survex 1.0.
4666  The mousewheel now zooms in/out (it doesn't do anything in 1.0) and
4667  left drag is now smart about not rotating and zooming at the same
4668  time.
4669
4670* aven: Highlighting stations now happens as you type, and pressing
4671  "Enter" or clicking the "Find" button now pans and zooms to show the
4672  highlighted stations.
4673
4674* aven: Left-clicking away from a station now cancels measuring line.
4675
4676* aven: Setting view to North, South, East, or West is now animated like
4677  the tilt from plan to elevation.
4678
4679* aven: Fix presentation saving to also write "." for decimal points and
4680  presentation loading to accept either "." or ",".
4681
4682* (Unix version): aven: Add text for all toolbar items so that aven
4683  will work with the Gnome desktop preference for displaying toolbars as
4684  icons with text or just text (wxWidgets needs fixing first though).
4685
4686* (Unix version): aven: Remove the ability to detach the menu bar (yell
4687  if you actually used it and I'll restore it!)
4688
4689* aven: Add "all survey files" option to the "open file" dialog.
4690
4691* (MS Windows version): aven: Fix cursor keys to pan survey.
4692
4693* (MS Windows version): Built with wxWidgets 2.6.3 instead of 2.6.2.
4694
4695* (MS Windows version): Fix installer to work on Windows 2000 or XP if
4696  run by an unprivileged user.
4697
4698* (MS Windows version): Upgrade to the latest version of InnoSetup (the
4699  installer builder we use) and include new installer translations for
4700  UK English, Spanish, Brazilian Portuguese, Italian, Romanian, and Slovak.
4701
4702* (MS Windows version): aven: Include Catalan and Brazilian Portuguese
4703  translations of messages for wxWidgets (the GUI library we use).
4704
4705* aven: Disable "Highlight exported points" if there aren't any.
4706
4707* Updates to French translation from Michel Bovey.  Also updates to German,
4708  Italian, Catalan, Spanish, and Romanian translations.
4709
4710* (Unix version): test suite: fix smoke test to pass even without X running
4711  (it was meant to but the code had a bug).
4712
4713* aven: Check if OpenGL is available and exit cleanly with a helpful error
4714  if it isn't.
4715
4716* (Unix version): aven: Fix --help and --version to work without a working
4717  X display (provided it's built with wxWidgets 2.5.1 or newer).
4718
4719* aven: Automatically select the presentation tab of the notebook when the user
4720  selects "New Presentation" or "Open Presentation".
4721
4722* aven: Fix "Delete" in the presentation list to not get passed on (and so not
4723  reset to default view as well).
4724
4725* aven: Fix Ctrl+Insert in the presentation list not to segfault if the list is
4726  empty.
4727
4728* aven: Fix Cursor Up and Down in the presentation list to move the highlight
4729  up and down instead of being passed on and moving the survey.
4730
4731* aven: Improve SVG output compatibility.  Tested with Mozilla Firefox 1.5,
4732  Adobe's SVG browser plugin, Gimp 2.2.8, Gqview 2.0.0, Opera 8.5,
4733  Safari 2.0.3, and InkScape 0.42.
4734
4735* aven: Put a 5mm border around exported SVG files to allow for station markers
4736  and non-zero width lines.
4737
4738* aven: Fix crash when exporting as SVG or Sketch if labels or surface data
4739  was turned on.
4740
4741* aven: Actually close the file we're exporting which fixes problems with it
4742  not always being fully written.
4743
4744Changes in 1.1.7 (2005.10.18):
4745
4746* cavern: Add validity checking for dates in *date commands (with feature
4747  test in testsuite).  A date entered as just "year" or "year.month" now
4748  becomes a date range for the relevant period (previously it became a single
4749  date near the middle of that period).
4750
4751* extend: Fixed 2 uninitialised flags (should fix erratic behaviour on
4752  with MS Windows).
4753
4754* extend: Default output name for a file called input.3d is now input_extend.3d
4755  rather than just extend.3d (which was annoying if you wanted to extend
4756  several surveys in the same directory).
4757
4758* aven: OpenGL 2.0 always includes support for point sprites so rework
4759  our check for them to include that knowledge.
4760
4761* aven: Regenerate depth bar if user switches to/from metric units.
4762
4763* aven: Don't clear the "there" mark just because the mouse pointer has
4764  moved off a station.
4765
4766* aven: When processing a .svx file, put the resultant .3d file in the
4767  same directory (since that's where we then try to load it from).
4768
4769* aven: Fix labelling of date colouring on 32 bit platforms.
4770
4771* aven: If "colour by date" is on and we load a survey with no date info
4772  (or all surveyed on the same date) then set "colour by none".
4773
4774* aven: Make the error dialog modal and remove a signal handler once it
4775  has fired to prevent endless (or seemingly endless) cascades of error
4776  dialogs.
4777
4778* aven: Enforce a minimum object volume diameter of 1m to avoid problems
4779  if a survey file with only one station in is loaded.
4780
4781* aven: Fix problems with indicators disappearing when we're drawing
4782  blobs and/or crosses the slow (but always supported) way.  (Problem
4783  introduced in 1.1.6).
4784
4785* (Unix version): aven: Really stop setting extra toolbar margin when using
4786  GTK2.0.  The attempt to fix this in 1.1.3 failed because __WXGTK12__ is
4787  set for GTK+ 1.2 or *any later release* so is true for GTK+ 2.0 too!
4788
4789* (Unix version): aven: Add details of which of wxGTK, wxMotif, and wxX11
4790  we've been compiled with, and which GTK+/Motif version where appropriate.
4791
4792* (Unix version): Fixed build on Fedora Core 3.
4793
4794* documentation: Updates to 3d file format specification from Mike McCombe.
4795
4796Changes in 1.1.6 (2005.10.10):
4797
4798* (MS Windows version): Distribution is about a third smaller than 1.1.5
4799  (mostly because mingwm10.dll is no longer required).
4800
4801* aven: If aven is asked to load a .svx, .dat, or .mak file, run cavern on
4802  it, showing cavern's output in a window (with errors and warnings clickable
4803  to load the offending file into an editor), and then loading the resulting
4804  3d file.
4805
4806* aven: Added "Colour by Date" option.
4807
4808* aven: Disable "Colour by Depth" option if there's no elevation variation.
4809
4810* aven: Don't crash if trying to load a survey with no elevation variation.
4811  Instead turn off depth colouring.
4812
4813* aven: Export as HPGL added.
4814
4815* aven: Improved update of mouse coordinates and measuring line (thanks to
4816  Martin Green).
4817
4818* aven: Show the coordinates of either the mouse pointer or the nearest
4819  survey station to it (if there is one near enough).  Showing both was
4820  confusing and meant the status bar overflowed on smaller displays.
4821
4822* aven: When printing an extended elevation, don't show bearing and elevation.
4823
4824* aven: Don't lock "flat" surveys which aren't extended elevations - a
4825  flat survey with LRUD data isn't flat any more!
4826
4827* aven: When we have to draw blobs and crosses the slow way (because the
4828  graphics hardware doesn't support the fast way), draw them so that they
4829  should appear at the correct depth into the 3D scene instead of on top
4830  of everything else.
4831
4832* aven: Make "play presentation backwards" icon green to match the other
4833  presentation icons.
4834
4835* (MS Windows version): aven: Mouse clicks on the survey view now set the
4836  keyboard focus there.
4837
4838* (MS Windows version): aven: Fix first redraw of a newly loaded survey.
4839
4840* (MS Windows version): aven: Fix redrawing of measuring line.
4841
4842* cavern: Store dates for img_XSECT.
4843
4844* cavern: Fixed small one-off memory leak if you specify -o more than once.
4845
4846* (Unix version): Check environmental variable LC_MESSAGES when deciding what
4847  language to use for messages.
4848
4849* (MS Windows version): "Print" on a 3d file now prints through aven rather
4850  than the separate printer driver (Unix has done this for some time).
4851
4852* Removed old printer drivers.
4853
4854* img library: When creating a 3d file, ignore img_XSECT if we've been asked
4855  to write a file format version which doesn't support it.
4856
4857Changes in 1.1.5 (2005.09.20):
4858
4859* (MS Windows version): aven: Fixed crash on start-up (introduced in 1.1.4).
4860
4861* aven: Make blobs round like they are in Survex 1.0.
4862
4863* aven: If the graphics drivers don't support drawing blobs using OpenGL
4864  point markers, fall back to drawing filled circles.
4865
4866* aven: If the graphics drivers support it, draw crosses as texture mapped
4867  OpenGL point markers which is much faster.
4868
4869* aven: Cross size increased to match Survex 1.0.
4870
4871* aven: We must update which blobs are displayed if display of surface or
4872  underground legs is toggled.
4873
4874* cavern: Fix handling of a *solve followed by survey data, none of which is
4875  attached to the previous data.
4876
4877* cavern: Fixed "No survey data" error when a *solve is followed by another
4878  *solve (or the implicit solve at the end of processing) with no data between
4879  them.
4880
4881Changes in 1.1.4 (2005.09.19):
4882
4883* aven: Added Aven's icon to the "About" dialog.
4884
4885* aven: Use localised character for the decimal point (e.g. "," in most
4886  continental European countries).
4887
4888* aven: Previously the survey tree would get focus and then take keypresses
4889  (e.g. "P", "L", "Delete").  Now we pass most keypresses across so they
4890  operate on the cave, and transfer the input focus across when we do.
4891
4892* aven: Make pressing "Return" in the tree control expand/collapse a subtree.
4893
4894* aven: Speed up intialisation by delaying creation of OpenGL lists until
4895  they're needed.
4896
4897* aven: Added Mark Shinwell's bounding box with shadow of the survey.
4898
4899* aven: Disable the "Tubes" button/menu item when there's no LRUD data.
4900
4901* aven: Reworded "Restore Default Settings" as "Restore Default View".
4902
4903* (Unix version): aven: Set sensible default margins for printing and preserve
4904  any margin values the user specifies between runs (previously margins
4905  defaulted to 0 each time aven was run).
4906
4907* Documentation: Document *DATA PASSAGE in the manual.
4908
4909Changes in 1.1.3 (2005.09.07):
4910
4911* (Microsoft Windows version): Fixed build problems.
4912
4913* cavern: Allow OMIT character (-) for left/right/up/down.
4914
4915* aven: Remove an unnecessary menu separator.
4916
4917* aven: Fix "Find" and "Hide" toolbar buttons to work with GTK2.0.
4918
4919* aven: Make the tooltip for "Hide" show the number of found stations.
4920
4921* aven: If * or ? is used in a glob-style pattern, force a non-substring match.
4922
4923* aven: Enable "New Presentation" when there's a 3d file loaded, rather than
4924  when there's a presentation loaded.
4925
4926* aven: Make entrances green in side panel tree list to match green blobs used
4927  in cave view.
4928
4929* aven: Don't show surface labels if we're not showing surface data, etc.
4930
4931* aven: Merge "Start Rotation" and "Stop Rotation" into "Toggle Rotation" and
4932  make "Space" the key for this.  Keep Return working "Stop Rotation" so
4933  existing users are happy, but don't advertise it.
4934
4935* aven: Normalise filename by adding any extension used, and use the normalised
4936  filename for file history and window title.
4937
4938* (Unix version): aven: Stop setting extra toolbar margin when using GTK2.0
4939  as the toolbar buttons already have a sensible margin - the extra margin is
4940  only needed with GTK1.2.
4941
4942* aven: Fix handling of plumb legs in tube model.
4943
4944* aven: Fixed swapped L and R in tube model.
4945
4946* extend: Preserve UD cross-section information in extended elevation.
4947
4948* extend: Add new messages for John Pybus' enhancements.
4949
4950Changes in 1.1.2 (never formally released):
4951
4952* Added support for LRUD data in .svx files, in .3d files, and aven can
4953  now load and display it on screen and on printouts.  The ability to "fake"
4954  LRUD data in aven is gone for now but will reappear in some form later.
4955
4956* cavern: Removed support for writing Chasm's 3dx format.  We're going to
4957  fold any desirable missing chasm functionality into aven.
4958
4959* aven: Rearranged mouse actions as discussed on the mailing list.  Added
4960  cursors for each different mouse action to help the user learn what each
4961  does.  Also added cursors for the "compass" and "clino" as well as the
4962  scalebar to suggest to the user that they can be dragged to change the view.
4963
4964* (Unix version): aven: Don't segfault if LANG isn't a known language.
4965
4966* tests/smoketest.tst: If X windows is running, check that we can run aven
4967  with --help and --version.
4968
4969* tests/cavern.tst: Fixed cavern.tst to warn if it is skipping a test because
4970  no results are listed for it.  This revealed that there was a "newline" test
4971  which should have been called "badnewline", and was a broken testcase too!
4972  Fixed all these problems.
4973
4974* cavern: Applied Simeon Warner's patch for handling backcompass, backclino,
4975  and omitted forward compass/clino readings in Compass DAT files.  Added
4976  a feature test for this to the testsuite.
4977
4978* It no longer makes sense to have an option not to build aven or to build aven
4979  without OpenGL so remove old machinery for this from configure and the
4980  sources.
4981
4982* (Unix version): configure: Check if "-lXxf86vm" is needed.
4983
4984* configure: Better output for strcasecmp test.
4985
4986* aven: Fix crosses to work much better.  Not a total fix - their position
4987  in the Z buffer isn't correct and they're rather slow to plot.
4988
4989* aven: Don't regenerate the hittest grid every time the mouse moves while
4990  animating, which solves the mysterious pausing effect (thanks go to Martin
4991  Green for spotting this!)  Also clear all the status bar coordinates when
4992  animating.
4993
4994* aven: Sort out clashing menu shortcuts in some languages.
4995
4996* aven: Fixed compilation problem on x86_64
4997
4998* SPUD: Pruned out stuff which has been done or which is not actually relevant
4999  to this branch.
5000
5001* Merge various changes from 1.0 branch:
5002
5003  + aven: Port over "printing from aven" functionality.
5004
5005  + aven: Port over "export as" functionality,
5006
5007  + Add David Loeffler's vim mode for .svx files.
5008
5009* aven: Fix check for whether a label is behind us in perspective view.
5010
5011* aven: Don't use an opengl list for drawing the indicators - we typically make
5012  a new list each time we plot them anyway.
5013
5014* Remove lingering traces of support for RISC OS and pre-386 MSDOS
5015
5016* aven: Set icon on non-Windows platforms too.  This means that with
5017  WindowMaker on Unix you get an icon on the AppIcon by default.
5018
5019* configure: Update wxWindows checks to handle newer wx versions.
5020
5021* Make all maintainer perl scripts "use bytes;" to avoid utf-8 double encoding
5022  problems.  They also all require Perl 5.8 now (hopefully this isn't an issue
5023  for anyone building from CVS).
5024
5025* acinclude.m4: Quote macro name for fix autotools warning.
5026
5027* Documentation: "tilt up" is "'" not ",".
5028
5029* aven: Add support for mousewheels (to tilt the cave).
5030
5031* aven: Fixed twisted transitions to and from pitches in certain cases.
5032
5033* aven: Pick a sensible initial window size when the user's desktop is spread
5034  over more than one monitor (works best with wx2.5 or newer, but try to do
5035  better with wx2.4 or earlier as well).
5036
5037* aven: Initialise GfxCore slightly later to avoid visual glitch from notebook
5038  contents being visible before any survey is loaded.
5039
5040* aven: Allow a coloured texture to be used
5041
5042* aven: Don't initialise until we have data (to the user, this means the window
5043  is default colour (grey for most systems) not black until a survey is
5044  loaded).
5045
5046* aven: Fixed weird "shadowed" icons.
5047
5048Changes in 1.1.1 (2004-10-06):
5049
5050* (Microsoft Windows version): aven: Hopefully fix loading a survey file at
5051  startup.
5052
5053* aven: Delay loading the bitmap for the "About" dialog until it is first
5054  needed.  We want start up to be as quick as possible.
5055
5056Changes between 1.0.32 and 1.1.0 (never formally released):
5057
5058* NOTE: Survex 1.1.X releases are development snapshots made available for
5059  the purposes of allowing wider testing and getting more user feedback.  Once
5060  the code has stabilised the version number will be raised to 1.2.0.
5061
5062* aven: Now uses OpenGL for 3d rendering - you may need to install drivers if
5063  you're using Windows 95 - these can be obtained from:
5064  http://download.microsoft.com/download/win95upg/info/1/W95/EN-US/Opengl95.exe
5065
5066* aven: Solid passages - passage dimensions are currently inferred from
5067  the leg length (pretty effective as you can measure longer legs in
5068  larger passages).  Use of real LRUD data coming soon...
5069
5070* aven: Depth colouring is now continuously varying.
5071
5072* aven: Colour by depth can now be turned off (and there's the start of a
5073  framework for properly implementing colour by date, error, etc).
5074
5075* aven: Find stations moved onto the toolbar and now uses a simple wildcarded
5076  match (? matches any character, * matches any number of characters).
5077
5078* aven: We now use the status bar for coordinates, distances, etc to make
5079  better use of screen space.
5080
5081* aven: Full screen mode (F11).
5082
5083* aven: Perspective view.
5084
5085* aven: Context sensitive cursor shape - needs more work.
5086
5087* aven: Mouse actions changed (hopefully they're now more natural, but
5088  you may find the change disorientating - feedback wanted on this).
5089
5090* aven: Added "presentations" which allow you to set up fly-through paths
5091  and load/save/run them.
5092
5093* aven: A presentation can be exported as a movie file.
5094
5095* aven: Added Save screenshot facility.
5096
5097* aven: Depth fogging option.
5098
5099* aven: Added Smooth Lines option.
5100
5101* aven: Added Textured Walls option.
5102
5103* aven: If a survey has surface legs but no underground legs, default to
5104  showing the surface legs.
5105
5106* cavern: Dates given to *date are now stored in the 3d file.
Note: See TracBrowser for help on using the repository browser.