source: git/NEWS @ d731218

main
Last change on this file since d731218 was d731218, checked in by Olly Betts <olly@…>, 3 weeks ago

NEWS: Fix typo in previous entry

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