source: git/NEWS @ f5e6be8

stereo-2025warn-only-for-hanging-survey
Last change on this file since f5e6be8 was 26bdac6, checked in by Olly Betts <olly@…>, 13 months ago

NEWS: Update

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