From 37dd94b3fed751433b7a7be57d6c6cfd74a0ef97 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 3 Apr 2026 01:25:30 +0000
Subject: [PATCH] fix(pkgbuild): install USAGE.md to /usr/share/doc/

USAGE.md is a generated file documenting CLI usage but was not being
installed by either PKGBUILD variant. Add it alongside README.md in
/usr/share/doc/$pkgname/.

https://claude.ai/code/session_01KsLCFmqMNrxwpH8a2SgmG9
---
 ci/github-actions/generate-pkgbuild.py3   | 3 ++-
 template/parallel-disk-usage-bin/PKGBUILD | 2 ++
 template/parallel-disk-usage/PKGBUILD     | 1 +
 3 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/ci/github-actions/generate-pkgbuild.py3 b/ci/github-actions/generate-pkgbuild.py3
index f258261f..8d19c4c6 100755
--- a/ci/github-actions/generate-pkgbuild.py3
+++ b/ci/github-actions/generate-pkgbuild.py3
@@ -21,6 +21,7 @@ for line in open('checksums/sha1sum.txt').readlines():
 
 maintainer = '# Maintainer: Hoàng Văn Khải <hvksmr1996@gmail.com>\n'
 readme_url = f'https://raw.githubusercontent.com/KSXGitHub/parallel-disk-usage/{release_tag}/README.md'
+usage_url = f'https://raw.githubusercontent.com/KSXGitHub/parallel-disk-usage/{release_tag}/USAGE.md'
 license_url = f'https://raw.githubusercontent.com/KSXGitHub/parallel-disk-usage/{release_tag}/LICENSE'
 
 opening = maintainer + '\n# This file is automatically generated. Do not edit.\n'
@@ -51,7 +52,7 @@ with open('./pkgbuild/parallel-disk-usage-bin/PKGBUILD', 'w') as pkgbuild:
     for ext in supported_completions
   )
   man_page_source = f'pdu.{release_tag}.1::{source_url_prefix}/pdu.1'
-  content += f'source=(pdu-{checksum}::{source_url} {completion_source} {man_page_source} {readme_url} {license_url})\n'
+  content += f'source=(pdu-{checksum}::{source_url} {completion_source} {man_page_source} {readme_url} {usage_url} {license_url})\n'
   content += f'_checksum={checksum}\n'
   completion_checksums = ' '.join('SKIP' for _ in supported_completions)
   content += f'_completion_checksums=({completion_checksums})\n'
diff --git a/template/parallel-disk-usage-bin/PKGBUILD b/template/parallel-disk-usage-bin/PKGBUILD
index d28a116f..efbe2a00 100644
--- a/template/parallel-disk-usage-bin/PKGBUILD
+++ b/template/parallel-disk-usage-bin/PKGBUILD
@@ -12,12 +12,14 @@ sha1sums=(
   "${_completion_checksums[@]}" # for the completion files
   SKIP                          # for the man page
   SKIP                          # for the readme file
+  SKIP                          # for the usage file
   SKIP                          # for the license file
 )
 
 package() {
   install -Dm755 "pdu-$_checksum" "$pkgdir/usr/bin/pdu"
   install -Dm644 README.md "$pkgdir/usr/share/doc/$pkgname/README.md"
+  install -Dm644 USAGE.md "$pkgdir/usr/share/doc/$pkgname/USAGE.md"
   install -Dm644 LICENSE "$pkgdir/usr/share/licenses/$pkgname/LICENSE"
   install -Dm644 "completion.$pkgver.bash" "$pkgdir/usr/share/bash-completion/completions/pdu"
   install -Dm644 "completion.$pkgver.fish" "$pkgdir/usr/share/fish/completions/pdu.fish"
diff --git a/template/parallel-disk-usage/PKGBUILD b/template/parallel-disk-usage/PKGBUILD
index 7e3c59aa..a4f95c5a 100644
--- a/template/parallel-disk-usage/PKGBUILD
+++ b/template/parallel-disk-usage/PKGBUILD
@@ -16,6 +16,7 @@ package() {
   cd "$srcdir/parallel-disk-usage-$pkgver"
   install -Dm755 target/release/pdu "$pkgdir/usr/bin/pdu"
   install -Dm644 README.md "$pkgdir/usr/share/doc/$pkgname/README.md"
+  install -Dm644 USAGE.md "$pkgdir/usr/share/doc/$pkgname/USAGE.md"
   install -Dm644 LICENSE "$pkgdir/usr/share/licenses/$pkgname/LICENSE"
   install -Dm644 exports/completion.bash "$pkgdir/usr/share/bash-completion/completions/pdu"
   install -Dm644 exports/completion.fish "$pkgdir/usr/share/fish/completions/pdu.fish"