# HG changeset patch
# User Chris Cannam
# Date 1591350368 -3600
# Node ID 3e0133aa235452f097748a1e834d976948bd6b0e
# Parent  ddcbbd85c1eab564ebc4e4f08c1b27f989b6f922
Update CHANGELOG; add warning about mp3/aac encoder delay to help

diff -r ddcbbd85c1ea -r 3e0133aa2354 CHANGELOG
--- a/CHANGELOG	Thu Jun 04 17:39:27 2020 +0100
+++ b/CHANGELOG	Fri Jun 05 10:46:08 2020 +0100
@@ -1,3 +1,26 @@
+
+Changes in Sonic Annotator 1.6 (5 June 2020) since the previous release 1.5:
+
+Front-end changes:
+
+ - Add support for reading the Opus audio codec on all platforms
+
+ - Add support for reading WMA and AAC formats on 64-bit Windows. (AAC
+   was already supported on macOS.)  Note that AAC support on Windows
+   is not "gapless", i.e. the decoder provides no way to identify and
+   remove the encoder gap at the start of the stream, so timings will
+   vary between Windows and Mac. For this reason, like mp3, AAC should
+   not be used as a file format of record
+
+ - Add warning to the help text about avoiding mp3 and AAC as file
+   format of record
+
+Build changes:
+
+ - General updates to dependency libraries and build system following
+   changes to the rest of the Sonic Visualiser family code since v1.5
+   appeared
+   
 
 Changes in Sonic Annotator 1.5 (25 May 2017) since the previous release 1.4:
 
diff -r ddcbbd85c1ea -r 3e0133aa2354 runner/main.cpp
--- a/runner/main.cpp	Thu Jun 04 17:39:27 2020 +0100
+++ b/runner/main.cpp	Fri Jun 05 10:46:08 2020 +0100
@@ -257,6 +257,16 @@
     cerr << "Playlist files in M3U format are also supported." << endl;
     cerr << endl;
 
+    if (extlist.contains("*.mp3")) {
+        QString warning = "(Note: It's wise to avoid using %1 as a source format, even in cases where lossy compression is not considered problematic: the handling of initial encoder delay can vary between decoders, and possibly even between builds of %2, so feature timings may not be consistent.)";
+        if (extlist.contains("*.m4a")) {
+            warning = warning.arg("mp3 or mp4 (aac, m4a)").arg(myname);
+        } else {
+            warning = warning.arg("mp3").arg(myname);
+        }
+        cerr << wrap(warning, 78, 0) << endl << endl;
+    }
+
     set<string> writers = FeatureWriterFactory::getWriterTags();
 
     QString writerText = "Supported writer types are: ";