1 files changed, 36 insertions, 0 deletions
diff --git a/man/apkg-clean.8 b/man/apkg-clean.8
new file mode 100644
index 0000000..6cca0f2
--- /dev/null
+++ b/man/apkg-clean.8
@@ -0,0 +1,36 @@
+.\" -*- mode: troff; coding: utf-8 -*-
+.TH APKG-CLEAN 8
+.SH NAME
+apkg-clean \- clean up unreferenced package and source files
+.SH DESCRIPTION
+.LP
+\fBapkg-clean\fR scans the package and source directories and prints paths to
+files that are no longer referenced by any current package recipe. Output is
+intended to be piped to \fBxargs rm\fR for cleanup.
+.SH OPTIONS
+.TP
+\fB-p\fR
+Print unreferenced package files (\fI*.spm\fR) only.
+.TP
+\fB-s\fR
+Print unreferenced source files only.
+.TP
+\fB-h\fR
+Print help message.
+.SH EXAMPLES
+.LP
+\f(CRapkg-clean\fR - Print all unreferenced files (packages and sources).
+.PP
+\f(CRapkg-clean | xargs rm -v\fR - Remove all unreferenced package and source files.
+.PP
+\f(CRapkg-clean -p | xargs rm\fR - Remove only unreferenced package files.
+.SH AUTHORS
+.LP
+emmett1 \c
+.MT me@emmett1.my
+.ME
+.SH REPORTING BUGS
+.LP
+Please report bugs and issues in the project issue tracker: \c
+.UR https://codeberg.org/emmett1/autils/issues
+.UE