From 7412e421c6ae36ec146529fb95fe3542f5545313 Mon Sep 17 00:00:00 2001
From: Adam Williamson <awilliam@redhat.com>
Date: Feb 24 2026 22:16:50 +0000
Subject: Explain what failedpackages is for


I think I can see what this is meant to do. Dunno if we really
need to keep it, but hey, at least this should make it possible
to decide.

Signed-off-by: Adam Williamson <awilliam@redhat.com>

---

diff --git a/README.md b/README.md
index 64e40b7..fd23fed 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@ This repo contains scripts useful to various program management functions:
 
 * `changes/` — Managing the Changes process
 * `closebugs/` — Bugzilla branch and EOL
-* `failedpackages/` — ?? (Hasn't been used since bcotton started)
+* `failedpackages/` — find old source packages in a development tree
 * `provenpackager/` — Checking for inactive provenpackagers
 
 To generate a bugzilla token, go to API key tab in the user preferences in your profile and generate a new API key.
diff --git a/failedpackages/failedpackages b/failedpackages/failedpackages
index 1953cf8..a7a2d3f 100755
--- a/failedpackages/failedpackages
+++ b/failedpackages/failedpackages
@@ -1,5 +1,12 @@
 #!/bin/bash
 
+# this script is intended to find old source packages in a development tree
+# example:
+# failedpackages -b 44 -e 44
+# will find all source packages in branched Fedora 44 that are *not* .fc44.src.rpm
+# failedpackages -b rawhide -e 45 -e2 44
+# will find all source packages in Rawhide that are not .fc45 or .fc44
+
 function usage() {
     echo "Usage:" 1>&2
     echo "    $0 <-b|--branch branch> <-e|--exclude exclude> <-e2|--exclude2 exclude2> [--help]" 1>&2