source: git/NEWS @ 57763ab

stereo-2025
Last change on this file since 57763ab was 92debc5, checked in by Olly Betts <olly@…>, 11 months ago

Add draft NEWS entry

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