newapkbuild.1: fix mdoc style
This commit is contained in:
parent
6cc2e53f3f
commit
3d0080de5e
|
@ -1,13 +1,9 @@
|
||||||
.Dd November 4, 2017
|
.Dd November 4, 2017
|
||||||
.Dt NEWAPKBUILD 1 PRM
|
.Dt NEWAPKBUILD 1 PRM
|
||||||
.Os "Alpine Linux"
|
.Os "Alpine Linux"
|
||||||
|
|
||||||
|
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm newapkbuild
|
.Nm newapkbuild
|
||||||
.Nd generate a new APKBUILD
|
.Nd generate a new APKBUILD
|
||||||
|
|
||||||
|
|
||||||
.Sh SYNOPSIS
|
.Sh SYNOPSIS
|
||||||
.Nm
|
.Nm
|
||||||
.Op Fl n Ar NAME
|
.Op Fl n Ar NAME
|
||||||
|
@ -17,7 +13,6 @@
|
||||||
.Op Fl aCmpy
|
.Op Fl aCmpy
|
||||||
.Op Fl cfhs
|
.Op Fl cfhs
|
||||||
.Op Ar pkgname Op Ar -pkgver
|
.Op Ar pkgname Op Ar -pkgver
|
||||||
|
|
||||||
.Nm
|
.Nm
|
||||||
.Op Fl n Ar NAME
|
.Op Fl n Ar NAME
|
||||||
.Op Fl d Ar DESC
|
.Op Fl d Ar DESC
|
||||||
|
@ -26,65 +21,52 @@
|
||||||
.Op Fl aCmpy
|
.Op Fl aCmpy
|
||||||
.Op Fl cfhs
|
.Op Fl cfhs
|
||||||
.Op Ar source_url
|
.Op Ar source_url
|
||||||
|
|
||||||
|
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
.Nm
|
.Nm
|
||||||
generates a new APKBUILD for use with
|
generates a new APKBUILD for use with
|
||||||
.Xr abuild 1 .
|
.Xr abuild 1 .
|
||||||
|
|
||||||
.Bl -tag -width "pkgname-pkgver" -offset indent -compact
|
.Bl -tag -width "pkgname-pkgver" -offset indent -compact
|
||||||
|
|
||||||
.It Fl n Ar NAME
|
.It Fl n Ar NAME
|
||||||
Specifies the name of the new package. A new directory called
|
Specifies the name of the new package.
|
||||||
|
A new directory called
|
||||||
.Ar NAME
|
.Ar NAME
|
||||||
will be created in the current directory, with the APKBUILD file.
|
will be created in the current directory, with the APKBUILD file.
|
||||||
|
|
||||||
.It Fl d Ar DESC
|
.It Fl d Ar DESC
|
||||||
Specifies the description (pkgdesc=) for the new package.
|
Specifies the description (pkgdesc=) for the new package.
|
||||||
|
|
||||||
.It Fl l Ar LICENSE
|
.It Fl l Ar LICENSE
|
||||||
Specifies the license under which the new package is distributed. This should
|
Specifies the license under which the new package is distributed.
|
||||||
match an SPDX Identifier.
|
This should match an SPDX Identifier.
|
||||||
|
|
||||||
.It Fl u Ar URL
|
.It Fl u Ar URL
|
||||||
Specifies the Web page (url=) for the new package. This should
|
Specifies the Web page (url=) for the new package.
|
||||||
|
This should
|
||||||
.Em not
|
.Em not
|
||||||
be the source package URL; it should be the project's main Web page.
|
be the source package URL; it should be the project's main Web page.
|
||||||
|
|
||||||
.It Fl c
|
.It Fl c
|
||||||
Causes
|
Causes
|
||||||
.Nm
|
.Nm
|
||||||
to additionally copy an init.d script, conf.d file, and sample pre- and post-
|
to additionally copy an init.d script, conf.d file, and sample pre- and post-
|
||||||
install scripts to the APKBUILD directory. This allows you to have a quick
|
install scripts to the APKBUILD directory.
|
||||||
start for daemon packages.
|
This allows you to have a quick start for daemon packages.
|
||||||
|
|
||||||
.It Fl f
|
.It Fl f
|
||||||
Forces
|
Forces
|
||||||
.Nm
|
.Nm
|
||||||
to overwrite an existing APKBUILD, if one already exists in the package
|
to overwrite an existing APKBUILD, if one already exists in the package
|
||||||
directory.
|
directory.
|
||||||
|
|
||||||
.It Fl h
|
.It Fl h
|
||||||
Displays usage information.
|
Displays usage information.
|
||||||
|
|
||||||
.It Fl s
|
.It Fl s
|
||||||
Create an automatic SourceForge URL for the package based on its name and
|
Create an automatic SourceForge URL for the package based on its name and
|
||||||
version. This is only valid if
|
version.
|
||||||
|
This is only valid if
|
||||||
.Ar pkgname-pkgver
|
.Ar pkgname-pkgver
|
||||||
is specified on the command line.
|
is specified on the command line.
|
||||||
|
|
||||||
.It Ar pkgname-pkgver
|
.It Ar pkgname-pkgver
|
||||||
Specify the package name, if not already specified by
|
Specify the package name, if not already specified by
|
||||||
.Fl n .
|
.Fl n .
|
||||||
If followed by a dash (-) and a valid version string, additionally specify the
|
If followed by a dash (-) and a valid version string, additionally specify the
|
||||||
package's version.
|
package's version.
|
||||||
|
|
||||||
.El
|
.El
|
||||||
|
|
||||||
|
|
||||||
.Ss Build system type
|
.Ss Build system type
|
||||||
|
|
||||||
.Nm
|
.Nm
|
||||||
will try to automatically detect the build system by inspecting the source
|
will try to automatically detect the build system by inspecting the source
|
||||||
directory if
|
directory if
|
||||||
|
@ -92,45 +74,34 @@ directory if
|
||||||
is specified, and write out typical build instructions for that build system.
|
is specified, and write out typical build instructions for that build system.
|
||||||
If you do not specify the source URL, or you want to override auto-detection,
|
If you do not specify the source URL, or you want to override auto-detection,
|
||||||
you may specify one of the following four flags:
|
you may specify one of the following four flags:
|
||||||
|
|
||||||
.Bl -tag -width "-a" -offset indent -compact
|
.Bl -tag -width "-a" -offset indent -compact
|
||||||
|
|
||||||
.It Fl a
|
.It Fl a
|
||||||
Specifies that the package uses autotools. The APKBUILD will contain a typical
|
Specifies that the package uses autotools.
|
||||||
invocation of ./configure, make, and make install.
|
The APKBUILD will contain a typical invocation of ./configure, make, and make
|
||||||
|
install.
|
||||||
.It Fl C
|
.It Fl C
|
||||||
Specifies that the package uses CMake. CMake will be added to the makedepends
|
Specifies that the package uses CMake.
|
||||||
and a typical CMake invocation will be added to the APKBUILD.
|
CMake will be added to the makedepends and a typical CMake invocation will be
|
||||||
|
added to the APKBUILD.
|
||||||
.It Fl m
|
.It Fl m
|
||||||
Specifies that the package uses Meson. A typical Meson and Ninja invocation
|
Specifies that the package uses Meson.
|
||||||
will be added to the APKBUILD.
|
A typical Meson and Ninja invocation will be added to the APKBUILD.
|
||||||
|
|
||||||
.It Fl p
|
.It Fl p
|
||||||
Specifies that the package uses a Perl Makefile.PL file. The CPAN template
|
Specifies that the package uses a Perl Makefile.PL file.
|
||||||
will be used.
|
The CPAN template will be used.
|
||||||
|
|
||||||
.It Fl y
|
.It Fl y
|
||||||
Specifies that the package uses a Python setup.py build system. Python will be
|
Specifies that the package uses a Python setup.py build system.
|
||||||
added to the makedepends.
|
Python will be added to the makedepends.
|
||||||
|
|
||||||
.El
|
.El
|
||||||
|
|
||||||
If you do not specify any option, and you do not specify the source URL, the
|
If you do not specify any option, and you do not specify the source URL, the
|
||||||
generated APKBUILD file will not contain any build instructions.
|
generated APKBUILD file will not contain any build instructions.
|
||||||
|
|
||||||
|
|
||||||
.Sh FILES
|
.Sh FILES
|
||||||
|
|
||||||
All files generated will be placed in a
|
All files generated will be placed in a
|
||||||
.Pa pkgname
|
.Pa pkgname
|
||||||
directory inside the current working directory, with
|
directory inside the current working directory, with
|
||||||
.Pa pkgname
|
.Pa pkgname
|
||||||
being created if it does not exist.
|
being created if it does not exist.
|
||||||
|
|
||||||
.Bl -tag -width "pkgname.post-install" -compact
|
.Bl -tag -width "pkgname.post-install" -compact
|
||||||
|
|
||||||
.It Pa APKBUILD
|
.It Pa APKBUILD
|
||||||
.Nm
|
.Nm
|
||||||
will create
|
will create
|
||||||
|
@ -140,10 +111,8 @@ with the details gathered from the invocation of
|
||||||
and introspection of the downloaded package source if
|
and introspection of the downloaded package source if
|
||||||
.Ar source_url
|
.Ar source_url
|
||||||
is provided.
|
is provided.
|
||||||
|
|
||||||
For more information about APKBUILD and its format, see
|
For more information about APKBUILD and its format, see
|
||||||
.Xr APKBUILD 5 .
|
.Xr APKBUILD 5 .
|
||||||
|
|
||||||
.It Pa pkgname.initd
|
.It Pa pkgname.initd
|
||||||
If
|
If
|
||||||
.Fl c
|
.Fl c
|
||||||
|
@ -152,7 +121,6 @@ is given,
|
||||||
will create
|
will create
|
||||||
.Pa pkgname.initd
|
.Pa pkgname.initd
|
||||||
with example data to assist in the creation of an init.d script for a daemon.
|
with example data to assist in the creation of an init.d script for a daemon.
|
||||||
|
|
||||||
.It Pa pkgname.confd
|
.It Pa pkgname.confd
|
||||||
If
|
If
|
||||||
.Fl c
|
.Fl c
|
||||||
|
@ -161,12 +129,11 @@ is given,
|
||||||
will create
|
will create
|
||||||
.Pa pkgname.confd
|
.Pa pkgname.confd
|
||||||
to assist in the creation of a conf.d file for a daemon, used by init.d
|
to assist in the creation of a conf.d file for a daemon, used by init.d
|
||||||
scripts. conf.d files are used to configure init.d scripts; for more
|
scripts.
|
||||||
information, see
|
conf.d files are used to configure init.d scripts; for more information, see
|
||||||
.Xr openrc 8
|
.Xr openrc 8
|
||||||
and
|
and
|
||||||
.Xr rc_config 3 .
|
.Xr rc_config 3 .
|
||||||
|
|
||||||
.It Pa pkgname.pre-install
|
.It Pa pkgname.pre-install
|
||||||
If
|
If
|
||||||
.Fl c
|
.Fl c
|
||||||
|
@ -177,7 +144,6 @@ will create
|
||||||
the contents of which will be run by
|
the contents of which will be run by
|
||||||
.Xr apk 8
|
.Xr apk 8
|
||||||
before the package is installed.
|
before the package is installed.
|
||||||
|
|
||||||
.It Pa pkgname.post-install
|
.It Pa pkgname.post-install
|
||||||
If
|
If
|
||||||
.Fl c
|
.Fl c
|
||||||
|
@ -188,33 +154,22 @@ will create
|
||||||
the contents of which will be run by
|
the contents of which will be run by
|
||||||
.Xr apk 8
|
.Xr apk 8
|
||||||
after the package is successfully installed.
|
after the package is successfully installed.
|
||||||
|
|
||||||
For more information about apk install hooks, consult the
|
For more information about apk install hooks, consult the
|
||||||
.Xr apk 8
|
.Xr apk 8
|
||||||
manual.
|
manual.
|
||||||
|
|
||||||
.El
|
.El
|
||||||
|
|
||||||
|
|
||||||
.Sh EXAMPLES
|
.Sh EXAMPLES
|
||||||
|
|
||||||
newapkbuild -n sharutils -d "Utilities for manipulating shell archives" \\
|
newapkbuild -n sharutils -d "Utilities for manipulating shell archives" \\
|
||||||
-l "GPL-3.0+" -u "https://www.gnu.org/software/sharutils/" -a \\
|
-l "GPL-3.0+" -u "https://www.gnu.org/software/sharutils/" -a \\
|
||||||
https://ftp.gnu.org/gnu/sharutils/sharutils-4.15.2.tar.xz
|
https://ftp.gnu.org/gnu/sharutils/sharutils-4.15.2.tar.xz
|
||||||
|
|
||||||
|
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
|
|
||||||
SPDX license reference (on the Web at <https://spdx.org/licenses/>),
|
SPDX license reference (on the Web at <https://spdx.org/licenses/>),
|
||||||
.Xr abuild 1 ,
|
.Xr abuild 1 ,
|
||||||
.Xr apk 8 ,
|
.Xr apk 8 ,
|
||||||
.Xr APKBUILD 5 .
|
.Xr APKBUILD 5 .
|
||||||
|
|
||||||
|
|
||||||
.Sh AUTHORS
|
.Sh AUTHORS
|
||||||
|
|
||||||
.Nm :
|
.Nm :
|
||||||
.An Natanael Copa Aq Mt ncopa@alpinelinux.org
|
.An Natanael Copa Aq Mt ncopa@alpinelinux.org
|
||||||
|
.Pp
|
||||||
Documentation:
|
Documentation:
|
||||||
.An A. Wilcox Aq Mt awilfox@adelielinux.org
|
.An A. Wilcox Aq Mt awilfox@adelielinux.org
|
||||||
|
|
Loading…
Reference in New Issue