Release FLAC 1.4.1

xiph · Sep 22, 2022 · b6fbd6b · b6fbd6b
1 parent a076395
commit b6fbd6b
Show file tree

Hide file tree

Showing 9 changed files with 58 additions and 8 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,7 +2,19 @@
 
 This changelog is not exhaustive, review [the git commit log](https://github.com/xiph/flac/commits) for an exhaustive list of changes.
 
-## FLAC 1.4.0
+## FLAC 1.4.1 (22-Sep-2022)
+
+This release only has a few changes. It was triggered by a problem in the 1.4.0 tarball: man pages were empty and api documentation missing
+
+* CMake fixes (Tomasz Kłoczko)
+* Add checks that man pages and api docs end up in tarball
+* Enable installation of prebuilt man pages and api docs
+* Fix compiler warnings (Johannes Kauffmann, Ozkan Sezer)
+* Fix format specifier (manxorist)
+* Enable building on Universal Windows Platform (Steve Lhomme)
+* Fix versioning from git
+
+## FLAC 1.4.0 (09-Sep-2022)
 
 As there have been changes to the library interfaces, the libFLAC version number is incremented to 12, the libFLAC++ version number is incremented to 10. As some changes were breaking, the version age numbers (see [libtool versioning](https://www.gnu.org/software/libtool/manual/libtool.html#Libtool-versioning)) have been reset to 0. For more details on the changes to the API, see the [porting guide](https://xiph.org/flac/api/group__porting__1__3__4__to__1__4__0.html).
 

diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -8,7 +8,7 @@ if(NOT (CMAKE_BUILD_TYPE OR CMAKE_CONFIGURATION_TYPES OR DEFINED ENV{CFLAGS} OR
     set(CMAKE_BUILD_TYPE Release CACHE STRING "Choose the type of build, options are: None Debug Release RelWithDebInfo")
 endif()
 
-project(FLAC VERSION 1.4.0) # HOMEPAGE_URL "https://www.xiph.org/flac/")
+project(FLAC VERSION 1.4.1) # HOMEPAGE_URL "https://www.xiph.org/flac/")
 
 list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake")
 

diff --git a/configure.ac b/configure.ac
@@ -19,7 +19,7 @@
 # instead of FLAC__ since autoconf triggers off 'AC_' in strings
 
 AC_PREREQ(2.60)
-AC_INIT([flac],[1.4.0],[[email protected]],[flac],[https://www.xiph.org/flac/])
+AC_INIT([flac],[1.4.1],[[email protected]],[flac],[https://www.xiph.org/flac/])
 AC_CONFIG_HEADERS([config.h])
 AC_CONFIG_SRCDIR([src/flac/main.c])
 AC_CONFIG_MACRO_DIR([m4])

diff --git a/doc/Doxyfile.in b/doc/Doxyfile.in
@@ -32,7 +32,7 @@ PROJECT_NAME           = FLAC
 # This could be handy for archiving the generated documentation or
 # if some version control system is used.
 
-PROJECT_NUMBER         = 1.4.0
+PROJECT_NUMBER         = 1.4.1
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer

diff --git a/doc/release_checklist.md b/doc/release_checklist.md
@@ -0,0 +1,38 @@
+1. Change version number in
+   - /configure.ac
+   - /CMakeLists.txt
+   - /doc/Doxyfile.in
+   - /man/flac.md
+   - /man/metaflac.md
+   - /test/metaflac-test-files/case07-expect.meta
+1. Change version date in
+   - /src/libFLAC/format.c
+   - /test/metaflac-test-files/case07-expect.meta
+1. Update changelog
+1. Check copyright year and update if applicable
+1. Check libFLAC and libFLAC++ for interface changes and update 
+    version numbers in include/FLAC/export.h and include/FLAC++/export.h
+1. Prepare and check release tarball by running 
+    `git clean -ffxd && ./autogen.sh && ./configure && make distcheck`
+1. Check whether release tarball contains api documentation and
+    generated man pages
+1. Prepare Windows release. Instructions are for building with MinGW-w64
+   - Take last release as template
+   - Update readme's if necessary
+   - Copy changelog and tool documentation
+   - Unpack tarball and create empty directories build64 and build32
+   - Unpack most recent libogg: change
+      `add_library(ogg ${OGG_HEADERS} ${OGG_SOURCES})` to
+      `add_library(ogg STATIC ${OGG_HEADERS} ${OGG_SOURCES})`
+   - Add `-static-libgcc` to FLAC's CFLAGS
+   - Add `-static-libgcc  -static-libstdc++ -Wl,-Bstatic,--whole-archive
+     -lwinpthread -Wl,-Bdynamic,--no-whole-archive` to FLAC's CXXFLAGS
+   - Run `CMake -DBUILD_SHARED_LIBS=ON .. && ninja` in both build64 and
+      build32 in the corresponding build environments
+   - Check dependencies of flac.exe, metaflac.exe, libFLAC.dll and
+      libFLAC++.dll, e.g. with objdump -x *.* | grep DLL.
+      Dependencies should only include KERNEL32.DLL, ADVAPI32.DLL,
+      msvcrt.dll and libFLAC.dll
+   - Copy flac.exe, metaflac.exe, libFLAC.dll and libFLAC++.dll of both
+      builds to proper directories
+   - Zip directory
diff --git a/man/flac.md b/man/flac.md
@@ -1,4 +1,4 @@
-% flac(1) Version 1.4.0 | Free Lossless Audio Codec conversion tool
+% flac(1) Version 1.4.1 | Free Lossless Audio Codec conversion tool
 
 # NAME
 

diff --git a/man/metaflac.md b/man/metaflac.md
@@ -1,4 +1,4 @@
-% metaflac(1) Version 1.4.0 | Free Lossless Audio Codec metadata tool
+% metaflac(1) Version 1.4.1 | Free Lossless Audio Codec metadata tool
 
 # NAME
 

diff --git a/src/libFLAC/format.c b/src/libFLAC/format.c
@@ -55,7 +55,7 @@ FLAC_API const char *FLAC__VENDOR_STRING = "reference libFLAC git-" GIT_COMMIT_H
 #else
 /* PACKAGE_VERSION should come from configure */
 FLAC_API const char *FLAC__VERSION_STRING = PACKAGE_VERSION;
-FLAC_API const char *FLAC__VENDOR_STRING = "reference libFLAC " PACKAGE_VERSION " 20220909";
+FLAC_API const char *FLAC__VENDOR_STRING = "reference libFLAC " PACKAGE_VERSION " 20220922";
 #endif
 
 FLAC_API const FLAC__byte FLAC__STREAM_SYNC_STRING[4] = { 'f','L','a','C' };

diff --git a/test/metaflac-test-files/case07-expect.meta b/test/metaflac-test-files/case07-expect.meta
@@ -1,4 +1,4 @@
-reference libFLAC 1.4.0 20220909
+reference libFLAC 1.4.1 20220922
 ARTIST=The_artist_formerly_known_as_the_artist...
 ARTIST=Chuck_Woolery
 ARTIST=Vern