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