source: git/NEWS @ 5910571

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

Update for 1.4.11

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