chore(changelog): update unreleased changelog

- Standardize help section delimiters across scripts
- Update `show_help` functions to extract help text dynamically
- Enhance maintainability and readability of help-related code

CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+## [unreleased]
+
+### 🚜 Refactor
+
+- *(help)* Improve help extraction for scripts - ([656d08d](https://git.0xmax42.io/actions/deb-changelog-action/commit/656d08d74f299d3c90aebfa67eac74f37662568f))
+
+## [0.2.0](https://git.0xmax42.io/actions/deb-changelog-action/compare/v0.1.1..v0.2.0) - 2025-07-02
+
+### 📚 Documentation
+
+- *(readme)* Update script reference in usage example - ([fb60cee](https://git.0xmax42.io/actions/deb-changelog-action/commit/fb60cee7482173db64f5946d493ac16d5ea6e57d))
+- *(run.sh)* Update script documentation and help output - ([fd29805](https://git.0xmax42.io/actions/deb-changelog-action/commit/fd29805fa1c15310f234857362cdfaa0124051e5))
+- *(script)* Improve help message layout and readability - ([b1644de](https://git.0xmax42.io/actions/deb-changelog-action/commit/b1644de411d789cb337ac250913a8aad2d53b40d))
+- *(run.sh)* Clarify version reference in comments - ([f1b790d](https://git.0xmax42.io/actions/deb-changelog-action/commit/f1b790d4e3ae7d5b2d2300405f6bfdb6898dc8d2))
+
 ## [0.1.1](https://git.0xmax42.io/actions/deb-changelog-action/compare/v0.1.0..v0.1.1) - 2025-06-27
 
 ### 🚀 Features

README.md

@@ -9,7 +9,7 @@ This repository provides a one-liner to generate a Debian-style changelog using
 You can run the generator directly from the URL:
 
 ```bash
-curl -s https://git.0xmax42.io/actions/deb-changelog-action/raw/branch/main/run.sh | bash -s -- \
+curl -s https://git.0xmax42.io/actions/deb-changelog-action/raw/branch/main/bootstrap.sh | bash -s -- \
   --tag v2.9.1 \
   --package_name my-package \
   --author_name "John Doe" \

VERSION

@@ -1 +1 @@
-0.1.1
+0.2.0

bootstrap.sh

@@ -1,12 +1,11 @@
 #!/usr/bin/env bash
+#=== HELP START ===
 # run.sh – local wrapper for the “deb-changelog-action”
 #
-# This script
-#   1. clones https://git.0xmax42.io/actions/deb-changelog-action at the
-#      requested tag into a temporary directory,
-#   2. installs git-cliff using the action’s helper script, and
-#   3. generates a Debian-style changelog **in the current working directory**
-#      via the action’s generator script.
+# Behaviour:
+#   • Clones https://git.0xmax42.io/actions/deb-changelog-action at the requested version into a temporary directory.
+#   • Installs git-cliff via the action’s helper script.
+#   • Generates a Debian-style changelog **in the current working directory** via the action’s generator script.
 #
 # Usage:
 #   ./run.sh --version v0 \
@@ -17,6 +16,16 @@
 #            [--output_file debian/changelog] \
 #            [--cliff_config path/to/cliff.toml]
 #
+# Options:
+#   --version <ver>        Action version to clone (required)
+#   --tag <tag>            Git tag used as starting point (required)
+#   --package_name <name>  Debian package name (required)
+#   --author_name <name>   Changelog author name (required)
+#   --author_email <mail>  Changelog author e-mail (required)
+#   --output_file <file>   Changelog path (default: debian/changelog)
+#   --cliff_config <file>  git-cliff config file (default: configs/cliff.debian.toml)
+#   -h, --help             Show this help message
+#
 # Notes:
 #   • Paths given for --output_file are interpreted relative to the directory
 #     where you run this script.
@@ -24,6 +33,7 @@
 #     (configs/cliff.debian.toml) is used.
 #   • PACKAGE_NAME, AUTHOR_NAME, AUTHOR_EMAIL are exported so the TOML template
 #     can reference them (e.g. {{ get_env(name="PACKAGE_NAME") }}).
+#=== HELP END ===
 set -euo pipefail
 
 REPO_URL="https://git.0xmax42.io/actions/deb-changelog-action"
@@ -38,7 +48,14 @@ OUTPUT_FILE="debian/changelog"
 CLIFF_CONFIG=""
 # ───────────────────────────────────────────────
 
-show_help() { sed -n '2,25p' "$0"; }
+show_help() {
+  sed -n '/^#=== HELP START ===/,/^#=== HELP END ===/ {
+    /^#=== HELP START ===/d
+    /^#=== HELP END ===/d
+    s/^#//
+    p
+  }' "$0"
+}
 
 # 1 ─ Parse CLI options ─────────────────────────
 while [[ $# -gt 0 ]]; do

scripts/generate-changelog.sh

@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+#=== HELP START ===
 # generate-changelog.sh – generates a Debian-style changelog via git-cliff
 #
 # Usage:
@@ -16,6 +17,7 @@
 #   • Checks that the config file exists and is readable.
 #   • Ensures the parent directory of the output file exists (unless --debug).
 #   • Generates the changelog; removes a leading empty line.
+#=== HELP END ===
 set -euo pipefail
 
 # ───────────────────────────────────────────────
@@ -25,7 +27,14 @@ OUT_FILE=""
 DEBUG=false
 # ───────────────────────────────────────────────
 
-show_help() { sed -n '2,18p' "$0"; }
+show_help() {
+  sed -n '/^#=== HELP START ===/,/^#=== HELP END ===/ {
+    /^#=== HELP START ===/d
+    /^#=== HELP END ===/d
+    s/^#//
+    p
+  }' "$0"
+}
 
 # 1 Parse CLI options
 while [[ $# -gt 0 ]]; do

scripts/install-git-cliff.sh

@@ -1,17 +1,29 @@
 #!/usr/bin/env bash
-# install-git-cliff.sh – fetches the latest or specified git-cliff binary
-# Usage (back-compatible):
-#   sudo ./install-git-cliff.sh                          # latest version, default arch/dir
-#   sudo ./install-git-cliff.sh 2.9.1                    # specific version
-# Extended options:
-#   sudo ./install-git-cliff.sh -a x86_64-linux-musl [<ver>]   # custom arch
-#   sudo ./install-git-cliff.sh -d /opt/tools [<ver>]          # custom install dir
-#   sudo ./install-git-cliff.sh -n [<ver>]                     # dry-run (no install)
-#   sudo ./install-git-cliff.sh -h | --help                    # help
-#
+#=== HELP START ===
+# install-git-cliff.sh – Installs the git-cliff binary
+
+# Usage:
+#   sudo ./install-git-cliff.sh [options] [<version>]
+
+# Options:
+#   -a, --arch <triplet>   Target architecture (default: ${DEFAULT_ARCH_DISPLAY})
+#   -d, --dir  <path>      Installation directory (default: ${INSTALL_DIR_DEFAULT})
+#   -n, --dry-run          Download and verify, but do NOT install
+#   -h, --help             Show this help message
+
+# Arguments:
+#   <version>              git-cliff version to install (default: latest)
+
 # Behaviour:
-#   • If git-cliff is already in \$PATH and **no version** was requested, the script exits early.
-#   • If a specific version was requested, the installed version is compared; identical → exit, different → upgrade.
+#   • If git-cliff is already in PATH and no version was requested the script exits.
+#   • If a specific version was requested, the installed version is compared and
+#     only upgraded if it differs.
+
+# Supported architecture triplets (examples):
+#   aarch64-linux-gnu / musl / apple-darwin / pc-windows-msvc
+#   i686-linux-gnu / musl / pc-windows-msvc
+#   x86_64-linux-gnu / musl / apple-darwin / pc-windows-*
+#=== HELP END ===
 set -euo pipefail
 
 REPO="orhun/git-cliff"
@@ -30,31 +42,12 @@ USER_VERSION_SPECIFIED=false
 
 # 0 Help function
 show_help() {
-  cat <<EOF
-install-git-cliff.sh – Installs the git-cliff binary
-
-Usage:
-  sudo ./install-git-cliff.sh [options] [<version>]
-
-Options:
-  -a, --arch <triplet>   Target architecture (default: ${DEFAULT_ARCH_DISPLAY})
-  -d, --dir  <path>      Installation directory (default: ${INSTALL_DIR_DEFAULT})
-  -n, --dry-run          Download and verify, but do NOT install
-  -h, --help             Show this help message
-
-Arguments:
-  <version>              git-cliff version to install (default: latest)
-
-Behaviour:
-  • If git-cliff is already in PATH and no version was requested the script exits.
-  • If a specific version was requested, the installed version is compared and
-    only upgraded if it differs.
-
-Supported architecture triplets (examples):
-  aarch64-linux-gnu / musl / apple-darwin / pc-windows-msvc
-  i686-linux-gnu / musl / pc-windows-msvc
-  x86_64-linux-gnu / musl / apple-darwin / pc-windows-*
-EOF
+  sed -n '/^#=== HELP START ===/,/^#=== HELP END ===/ {
+    /^#=== HELP START ===/d
+    /^#=== HELP END ===/d
+    s/^#//
+    p
+  }' "$0"
 }
 
 # 1 Parse options (keeps old single-arg form)