From b2cd320fe32cf3bd26a95003c640c154f4274bdd Mon Sep 17 00:00:00 2001 From: Rodolfo Wottrich Date: Thu, 27 Aug 2026 11:21:10 +0100 Subject: [PATCH 1/3] CI: cosmetic changes - Standardize all commit hashes to 7-character short form. - Restore table with links in README.md. --- .github/workflows/ci.yml | 2 +- README.md | 19 +++++++------------ _includes/navbar.html | 4 ++-- tools/acle_template.tex | 9 ++++++--- 4 files changed, 16 insertions(+), 18 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 356d0072..3a78a99f 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -20,7 +20,7 @@ jobs: run: ./build_with_docker.sh --finalversion - name: Derive short commit hash id: vars - run: echo "short_sha=${GITHUB_SHA::8}" >> "$GITHUB_OUTPUT" + run: echo "short_sha=${GITHUB_SHA::7}" >> "$GITHUB_OUTPUT" - name: Rename PDFs with commit hash run: | mv pdfs/acle.pdf "pdfs/acle-${{ steps.vars.outputs.short_sha }}.pdf" diff --git a/README.md b/README.md index 7e0feb7f..5a02a149 100644 --- a/README.md +++ b/README.md @@ -56,18 +56,13 @@ an email to arm.acle@arm.com. ## List of documents -[Arm C Language Extensions](https://arm-software.github.io/acle/main/) - -[Morello Supplement to the Arm C Language Extensions](https://arm-software.github.io/acle/morello/) - -[Arm MVE Intrinsics](https://arm-software.github.io/acle/mve_intrinsics/) - -[Arm Neon Intrinsics Reference](https://arm-software.github.io/acle/neon_intrinsics/) - -[Arm®v8-M Security Extensions - Requirements on Development Tools](https://arm-software.github.io/acle/cmse/) - -The PDF versions can be found in the latest GitHub -[release](https://github.com/ARM-software/acle/releases/latest). +HTML version | PDF version +--- | --- +[Arm C Language Extensions](https://arm-software.github.io/acle/main/) | [download](https://github.com/ARM-software/acle/releases/latest) +[Morello Supplement to the Arm C Language Extensions](https://arm-software.github.io/acle/morello/) | [download](https://github.com/ARM-software/acle/releases/latest) +[Arm MVE Intrinsics](https://arm-software.github.io/acle/mve_intrinsics/) | [download](https://github.com/ARM-software/acle/releases/latest) +[Arm Neon Intrinsics Reference](https://arm-software.github.io/acle/neon_intrinsics/) | [download](https://github.com/ARM-software/acle/releases/latest) +[Arm®v8-M Security Extensions - Requirements on Development Tools](https://arm-software.github.io/acle/cmse/) | [download](https://github.com/ARM-software/acle/releases/latest) # License diff --git a/_includes/navbar.html b/_includes/navbar.html index 5653d8a7..7fcc7d38 100644 --- a/_includes/navbar.html +++ b/_includes/navbar.html @@ -18,9 +18,9 @@ {% assign hash = site.commithash | default: site.github.build_revision %} {% if hash %} - {% assign short_hash = hash | slice: 0, 12 %} + {% assign short_hash = hash | slice: 0, 7 %} {% if site.finalversion %} - Version: {{ hash }}  :::  + Version: {{ short_hash }}  :::  {% elsif site.cleanrepo %} Version: Dev version ({{ short_hash }})  :::  {% else %} diff --git a/tools/acle_template.tex b/tools/acle_template.tex index 7626c373..f4083416 100644 --- a/tools/acle_template.tex +++ b/tools/acle_template.tex @@ -28,6 +28,7 @@ \usepackage{graphicx} \usepackage[$if(landscape)$landscape,$endif$top=3.7cm,bottom=2.7cm,left=3cm,right=2cm,headsep=1.5cm,footskip=.5cm]{geometry} \usepackage{lastpage} +\usepackage{xstring} % Add extra space to table rows \renewcommand{\arraystretch}{2} @@ -37,14 +38,16 @@ \patchcmd{\footrule}{\hrule}{\color{darkgray}\hrule}{}{} \makeatother +\StrLeft{$commithash$}{7}[\GitHashShort] + \sectionfont{\color{armblue}} $if(finalversion)$ - \newcommand{\versiontext}{\href{https://github.com/ARM-software/acle/commit/$commithash$}{$commithash$}} + \newcommand{\versiontext}{\href{https://github.com/ARM-software/acle/commit/$commithash$}{\GitHashShort}} $else$ $if(cleanrepo)$ - \newcommand{\versiontext}{\textcolor{red}{Development version based on \href{https://github.com/ARM-software/acle/commit/$commithash$}{$commithash$}}} + \newcommand{\versiontext}{\textcolor{red}{Development version based on \href{https://github.com/ARM-software/acle/commit/$commithash$}{\GitHashShort}}} $else$ - \newcommand{\versiontext}{\textcolor{red}{Development version based on \href{https://github.com/ARM-software/acle/commit/$commithash$}{$commithash$}, with modifications}} + \newcommand{\versiontext}{\textcolor{red}{Development version based on \href{https://github.com/ARM-software/acle/commit/$commithash$}{\GitHashShort}, with modifications}} $endif$ $endif$ \newcommand{\dateofissue}{$date-of-issue$} From 56e350d996bcd083e34c1601a7e1506abe2df0d6 Mon Sep 17 00:00:00 2001 From: Rodolfo Wottrich Date: Mon, 7 Sep 2026 14:39:08 +0100 Subject: [PATCH 2/3] Fix pdf artifacts to 7-char sha; link page to pdfs directly --- .github/workflows/ci.yml | 2 +- README.md | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 3a78a99f..3f30e19e 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -73,7 +73,7 @@ jobs: path: pdfs - name: Derive short commit hash id: vars - run: echo "short_sha=${GITHUB_SHA::8}" >> "$GITHUB_OUTPUT" + run: echo "short_sha=${GITHUB_SHA::7}" >> "$GITHUB_OUTPUT" - name: Create tag with PDFs uses: softprops/action-gh-release@v2 with: diff --git a/README.md b/README.md index 5a02a149..2a6fe909 100644 --- a/README.md +++ b/README.md @@ -58,11 +58,11 @@ an email to arm.acle@arm.com. HTML version | PDF version --- | --- -[Arm C Language Extensions](https://arm-software.github.io/acle/main/) | [download](https://github.com/ARM-software/acle/releases/latest) -[Morello Supplement to the Arm C Language Extensions](https://arm-software.github.io/acle/morello/) | [download](https://github.com/ARM-software/acle/releases/latest) -[Arm MVE Intrinsics](https://arm-software.github.io/acle/mve_intrinsics/) | [download](https://github.com/ARM-software/acle/releases/latest) -[Arm Neon Intrinsics Reference](https://arm-software.github.io/acle/neon_intrinsics/) | [download](https://github.com/ARM-software/acle/releases/latest) -[Arm®v8-M Security Extensions - Requirements on Development Tools](https://arm-software.github.io/acle/cmse/) | [download](https://github.com/ARM-software/acle/releases/latest) +[Arm C Language Extensions](https://arm-software.github.io/acle/main/) | [download](https://github.com/ARM-software/acle/releases/download/main-{{ site.commithash }}/acle-{{ site.commithash | slice: 0, 7 }}.pdf) +[Morello Supplement to the Arm C Language Extensions](https://arm-software.github.io/acle/morello/) | [download](https://github.com/ARM-software/acle/releases/download/main-{{ site.commithash }}/morello-{{ site.commithash | slice: 0, 7 }}.pdf) +[Arm MVE Intrinsics](https://arm-software.github.io/acle/mve_intrinsics/) | [download](https://github.com/ARM-software/acle/releases/download/main-{{ site.commithash }}/mve-{{ site.commithash | slice: 0, 7 }}.pdf) +[Arm Neon Intrinsics Reference](https://arm-software.github.io/acle/neon_intrinsics/) | [download](https://github.com/ARM-software/acle/releases/download/main-{{ site.commithash }}/advsimd-{{ site.commithash | slice: 0, 7 }}.pdf) +[Arm®v8-M Security Extensions - Requirements on Development Tools](https://arm-software.github.io/acle/cmse/) | [download](https://github.com/ARM-software/acle/releases/download/main-{{ site.commithash }}/cmse-{{ site.commithash | slice: 0, 7 }}.pdf) # License From b9f2ab2ad5101565ff9c4d6fbf20827346b7f89f Mon Sep 17 00:00:00 2001 From: Rodolfo Wottrich Date: Mon, 7 Sep 2026 15:23:27 +0100 Subject: [PATCH 3/3] Undo restore README links table --- README.md | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 4a2a3de2..5e830e16 100644 --- a/README.md +++ b/README.md @@ -56,13 +56,18 @@ an email to arm.acle@arm.com. ## List of documents -HTML version | PDF version ---- | --- -[Arm C Language Extensions](https://arm-software.github.io/acle/main/) | [download](https://github.com/ARM-software/acle/releases/download/main-{{ site.commithash }}/acle-{{ site.commithash | slice: 0, 7 }}.pdf) -[Morello Supplement to the Arm C Language Extensions](https://arm-software.github.io/acle/morello/) | [download](https://github.com/ARM-software/acle/releases/download/main-{{ site.commithash }}/morello-{{ site.commithash | slice: 0, 7 }}.pdf) -[Arm MVE Intrinsics](https://arm-software.github.io/acle/mve_intrinsics/) | [download](https://github.com/ARM-software/acle/releases/download/main-{{ site.commithash }}/mve-{{ site.commithash | slice: 0, 7 }}.pdf) -[Arm Neon Intrinsics Reference](https://arm-software.github.io/acle/neon_intrinsics/) | [download](https://github.com/ARM-software/acle/releases/download/main-{{ site.commithash }}/advsimd-{{ site.commithash | slice: 0, 7 }}.pdf) -[Arm®v8-M Security Extensions - Requirements on Development Tools](https://arm-software.github.io/acle/cmse/) | [download](https://github.com/ARM-software/acle/releases/download/main-{{ site.commithash }}/cmse-{{ site.commithash | slice: 0, 7 }}.pdf) +[Arm C Language Extensions](https://arm-software.github.io/acle/main/) + +[Morello Supplement to the Arm C Language Extensions](https://arm-software.github.io/acle/morello/) + +[Arm MVE Intrinsics](https://arm-software.github.io/acle/mve_intrinsics/) + +[Arm Neon Intrinsics Reference](https://arm-software.github.io/acle/neon_intrinsics/) + +[Arm®v8-M Security Extensions - Requirements on Development Tools](https://arm-software.github.io/acle/cmse/) + +The PDF versions can be found in the latest GitHub +[release](https://github.com/ARM-software/acle/releases/latest). # License