From 68b0bdbf1589c331b8f2982e546fadf38cb6a430 Mon Sep 17 00:00:00 2001 From: Peter Harris Date: Thu, 31 Oct 2024 20:57:42 +0000 Subject: [PATCH 1/3] Update version and docs for 5.0.0 --- CMakeLists.txt | 2 +- Docs/ChangeLog-4x.md | 23 ----------------------- Docs/ChangeLog-5x.md | 35 +++++++++++++++++++++++++++++++++++ README.md | 10 ++++------ 4 files changed, 40 insertions(+), 30 deletions(-) create mode 100644 Docs/ChangeLog-5x.md diff --git a/CMakeLists.txt b/CMakeLists.txt index e87a0528f..001dede5d 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -25,7 +25,7 @@ if(MSVC) add_compile_options("/wd4324") endif() -project(astcencoder VERSION 4.8.0) +project(astcencoder VERSION 5.0.0) set(CMAKE_CXX_STANDARD 14) set(CMAKE_CXX_STANDARD_REQUIRED ON) diff --git a/Docs/ChangeLog-4x.md b/Docs/ChangeLog-4x.md index 0228f8838..0e8216b32 100644 --- a/Docs/ChangeLog-4x.md +++ b/Docs/ChangeLog-4x.md @@ -6,29 +6,6 @@ release of the 4.x series. All performance data on this page is measured on an Intel Core i5-9600K clocked at 4.2 GHz, running `astcenc` using AVX2 and 6 threads. - -## 4.9.0 - -**Status:** In development - -The 4.9.0 release is a small release adding support for Arm Scalable Vector -Extensions SIMD, as well as some minor bug fixes. - -* **General:** - * **Bug fix:** Fixed incorrect return type in "None" vector library - reference implementation. - * **Bug fix:** Fixed sincos table index under/overflow. - * **Feature:** Changed `ASTCENC_ISA_NATIVE` builds to use `-march=native` and - `-mcpu=native`. - * **Feature:** Added backend for Arm SVE fixed-width 256-bit builds. These - can only run on hardware implementing 256-bit SVE. - * **Feature:** Added backend for Arm SVE 128-bit builds. These are portable - builds and can run on hardware implemnting any SVE vector length, but the - explicit SVE use is augmented NEON and will only use the bottom 128-bits of - each SVE vector. - * **Feature:** Optimized NEON mask `any()` and `all()` functions. - * **Feature:** Migrated build and test to GitHub Actions pipelines. - ## 4.8.0 diff --git a/Docs/ChangeLog-5x.md b/Docs/ChangeLog-5x.md new file mode 100644 index 000000000..527be5f65 --- /dev/null +++ b/Docs/ChangeLog-5x.md @@ -0,0 +1,35 @@ +# 4.x series change log + +This page summarizes the major functional and performance changes in each +release of the 4.x series. + +All performance data on this page is measured on an Intel Core i5-9600K +clocked at 4.2 GHz, running `astcenc` using AVX2 and 6 threads. + + +## 5.0.0 + +**Status:** November 2024 + +The 5.0.0 release is the first stable release in the 5.x series. The main new +feature is support for the Arm Scalable Vector Extensions (SVE) SIMD instruction +set. + +* **General:** + * **Bug fix:** Fixed incorrect return type in "None" vector library + reference implementation. + * **Bug fix:** Fixed sincos table index under/overflow. + * **Feature:** Changed `ASTCENC_ISA_NATIVE` builds to use `-march=native` and + `-mcpu=native`. + * **Feature:** Added backend for Arm SVE fixed-width 256-bit builds. These + can only run on hardware implementing 256-bit SVE. + * **Feature:** Added backend for Arm SVE 128-bit builds. These are portable + builds and can run on hardware implementing any SVE vector length, but the + explicit SVE use is augmented NEON and will only use the bottom 128-bits of + each SVE vector. + * **Feature:** Optimized NEON mask `any()` and `all()` functions. + * **Feature:** Migrated build and test to GitHub Actions pipelines. + +- - - + +_Copyright © 2022-2024, Arm Limited and contributors. All rights reserved._ diff --git a/README.md b/README.md index ce23b0208..402206db0 100644 --- a/README.md +++ b/README.md @@ -58,9 +58,7 @@ from 0.89 bits/pixel up to 8 bits/pixel. Release build binaries for the `astcenc` stable releases are provided in the [GitHub Releases page][3]. -* Change log: [4.x series](./Docs/ChangeLog-4x.md) -* Change log: [3.x series](./Docs/ChangeLog-3x.md) - +* Change log: [5.x series](./Docs/ChangeLog-5x.md) Binaries are provided for 64-bit builds on Windows, macOS, and Linux. ## Windows and Linux @@ -99,12 +97,12 @@ to be a stable branch for the latest major release series, but as it is used for ongoing development expect it to have some volatility. We recommend using the latest stable release tag for production development. -The `3.x` branch is a stable branch for the 3.x release series. It is no longer +The `4.x` branch is a stable branch for the 4.x release series. It is no longer under active development, but is a supported branch that continues to get backported bug fixes. -The `1.x` and `2.x` branches are stable branches for older releases. They are -no longer under active development or getting bug fixes. +The `1.x`, `2.x`, and `3.x` branches are stable branches for older releases. +They are no longer under active development or getting bug fixes. Any other branches you might find are development branches for new features or optimizations, so might be interesting to play with but should be considered From 6b12768981cb280e50218676b42dda8ecdfe2211 Mon Sep 17 00:00:00 2001 From: Peter Harris Date: Thu, 31 Oct 2024 20:59:09 +0000 Subject: [PATCH 2/3] Fix changelog --- Docs/ChangeLog-5x.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Docs/ChangeLog-5x.md b/Docs/ChangeLog-5x.md index 527be5f65..66bc49ce2 100644 --- a/Docs/ChangeLog-5x.md +++ b/Docs/ChangeLog-5x.md @@ -1,7 +1,7 @@ -# 4.x series change log +# 5.x series change log This page summarizes the major functional and performance changes in each -release of the 4.x series. +release of the 5.x series. All performance data on this page is measured on an Intel Core i5-9600K clocked at 4.2 GHz, running `astcenc` using AVX2 and 6 threads. From 69e6f0dd27ba2e59ef9a0935e66b000535d999ed Mon Sep 17 00:00:00 2001 From: Peter Harris Date: Thu, 31 Oct 2024 21:01:38 +0000 Subject: [PATCH 3/3] Make clear 4.x is old --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 402206db0..afb82862e 100644 --- a/README.md +++ b/README.md @@ -97,8 +97,8 @@ to be a stable branch for the latest major release series, but as it is used for ongoing development expect it to have some volatility. We recommend using the latest stable release tag for production development. -The `4.x` branch is a stable branch for the 4.x release series. It is no longer -under active development, but is a supported branch that continues to get +The `4.x` branch is a stable branch for the older 4.x release series. It is no +longer under active development, but is a supported branch that continues to get backported bug fixes. The `1.x`, `2.x`, and `3.x` branches are stable branches for older releases.