From 6236202f0946709efaabf3c329b3eeca31a9f50b Mon Sep 17 00:00:00 2001
From: Earl Warren <contact@earl-warren.org>
Date: Sat, 13 Jan 2024 18:19:56 +0100
Subject: [PATCH] actions: CASCADE_DOCS_FORCE_VERSION can force generating a
 version

---
 .forgejo/cascading-docs        | 2 +-
 .forgejo/workflows/actions.yml | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/.forgejo/cascading-docs b/.forgejo/cascading-docs
index 7bc4103..63a5bd9 100755
--- a/.forgejo/cascading-docs
+++ b/.forgejo/cascading-docs
@@ -14,7 +14,7 @@ fi
 
 cd $docs/docs/user
 
-if ! test -f actions-contexts/version.txt || test "$VERSION" != $(cat actions-contexts/version.txt) ; then
+if test "$FORCE_VERSION" = "$VERSION" || ! test -f actions-contexts/version.txt || test "$VERSION" != $(cat actions-contexts/version.txt) ; then
    rm -fr actions-contexts
    mkdir actions-contexts
    echo "$VERSION" > actions-contexts/version.txt
diff --git a/.forgejo/workflows/actions.yml b/.forgejo/workflows/actions.yml
index e2d70b2..a4f27a9 100644
--- a/.forgejo/workflows/actions.yml
+++ b/.forgejo/workflows/actions.yml
@@ -8,6 +8,9 @@
 #   forgejo-cascading-pr (https://codeberg.org/forgejo-cascading-pr)
 # secrets.CASCADE_DOCS_DESTINATION_TOKEN
 #   https://codeberg.org/forgejo-cascading-pr scope write:issue, write:repository, read:user
+# vars.CASCADE_DOCS_FORCE_VERSION
+#   replace the generated documentation for a given version even if it has already
+#   been generated (e.g. v1.22.0-test)
 #
 
 on:
@@ -75,4 +78,5 @@ jobs:
           prefix: ${{ env.GITHUB_REPOSITORY }}-${{ matrix.info.version }}
           update: .forgejo/cascading-docs
         env:
+          FORCE_VERSION: "${{ vars.CASCADE_DOCS_FORCE_VERSION }}"
           VERSION: "${{ steps.run.outputs.full_version }}"