source: git/NEWS @ 947c6ec

Last change on this file since 947c6ec was 5224435, checked in by Olly Betts <olly@…>, 9 days ago

Start draft NEWS entry

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