aboutsummaryrefslogtreecommitdiff
path: root/man/apkg-genabuild.8
diff options
context:
space:
mode:
Diffstat (limited to 'man/apkg-genabuild.8')
-rw-r--r--man/apkg-genabuild.835
1 files changed, 35 insertions, 0 deletions
diff --git a/man/apkg-genabuild.8 b/man/apkg-genabuild.8
new file mode 100644
index 0000000..69124b7
--- /dev/null
+++ b/man/apkg-genabuild.8
@@ -0,0 +1,35 @@
+.\" -*- mode: troff; coding: utf-8 -*-
+.TH APKG-GENABUILD 8
+.SH NAME
+apkg-genabuild \- generate an abuild recipe template from a source URL
+.SH DESCRIPTION
+.LP
+\fBapkg-genabuild\fR generates an \fIabuild\fR template file from a source URL.
+It attempts to parse the package name and version from the URL and creates
+a directory with a skeleton \fIabuild\fR recipe.
+.SH USAGE
+.LP
+\f(CRapkg-genabuild <url> [name]\fR
+.PP
+If \fIname\fR is not provided, it is derived from the URL.
+Special handling is included for GitHub tag archives, PyPI packages, and
+CPAN/Perl packages, which get the appropriate prefix (\fIpython-\fR or \fIperl-\fR).
+.SH OUTPUT
+.LP
+Creates a directory named after the package containing an \fIabuild\fR file
+with \fIname\fR, \fIversion\fR, \fIrelease\fR, and \fIsource\fR fields populated.
+.SH EXAMPLES
+.LP
+\f(CRapkg-genabuild https://example.com/pkg-1.2.3.tar.gz\fR - Generate template for a tarball.
+.PP
+\f(CRapkg-genabuild https://github.com/user/repo/archive/v1.0.tar.gz\fR - Generate template from a GitHub tag archive.
+.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