From 85d8088a5503c488b47101ebc7673626fa470367 Mon Sep 17 00:00:00 2001 From: Patrick McDermott Date: Sat, 16 Mar 2019 12:22:05 -0400 Subject: opkbuild(7): Update from opkhelper to opkbuild --- (limited to 'man') diff --git a/man/opkbuild.7in b/man/opkbuild.7in index ad13686..b3ed50b 100644 --- a/man/opkbuild.7in +++ b/man/opkbuild.7in @@ -1,174 +1,111 @@ -.TH OPKHELPER 7 \ +.TH OPKBUILD 7 \ "@DATE@" "@SOURCE@" "@MANUAL@" .SH NAME -opkhelper \- opkg build helper tools +opkbuild \- Distribution build system .SH DESCRIPTION -opkhelper is a set of programs to assist in building binary packages installable -by the lightweight package manager -.BR opkg . -These tools are inspired by debhelper, a similar set of programs written -primarily by Joey Hess for Debian. +opkbuild is a set of programs to build binary packages installable by the +lightweight package manager opkg. These tools are inspired by dpkg-dev, the +Debian package development tools. .sp -opkhelper 2.0.x is designed to build source packages that comply with draft -version 2.0 of the source package format at -.IR http://specs.os.pehjota.net/source-package-format-2.0.html . +opkbuild is designed to build source packages that comply with draft version 2.0 +of the source package format at <\fIhttp://specs.proteanos.com/spf-2.0/\fP>. -.SH MAINTAINER AND PACKAGE INTERFACES -opkhelper exposes various interfaces to users building packages and to packages -themselves. Users generally just call -.B opkbuild(1) -to begin building packages. The -.I build -file of a package generally calls a number of opkhelper tools to help it manage -and pack data and control files for packages. Additionally, -.B opkbuild(1) -documents the build environment by setting environment variables that are -available to the -.I build -file and other opkhelper tools. - -.SH OPKHELPER COMMANDS +.SH COMMANDS .TP -.B opkbuild(1) -Build opkg packages. -.sp -Executed by the user to begin building packages. +.BR opkbuild (1) +Build opkg packages .TP -.B ob-checkbuilddeps(1) -Make sure that package build dependencies are installed. -.sp -Executed by -.BR opkbuild(1) . +.BR ob-checkbuilddeps (1) +Make sure that package build dependencies are installed .TP -.B ob-applypatches(1) -Apply patches to source code. -.sp -Executed by -.BR opkbuild(1) . +.BR ob-buildenv (1) +Set up build environment variables .TP -.B ob-installplatconf(1) -Copy build-time or run-time platform configuration files. -.sp -Executed by -.BR opkbuild(1) . +.BR ob-unpacksource (1) +Unpack native or upstream source code .TP -.B ob-strip(1) -Strip binary objects of symbols. -.sp -Generally executed by package -.I build -files. +.BR ob-applypatches (1) +Apply patches to source code .TP -.B ob-installfiles(1) -Install files into a binary package staging area. -.sp -Generally executed by package -.I build -files. +.BR ob-installplatconf (1) +Copy build-time or run-time platform configuration files .TP -.B ob-installdocs(1) -Install package documentation into a binary package staging area. -.sp -Generally executed by package -.I build -files. +.BR ob-installdocs (1) +Install package documentation into a binary package staging area .TP -.B ob-gencontrol(1) -Generates a control directory with a control file and scripts. -.sp -Generally executed by package -.I build -files. +.BR ob-gencontrol (1) +Generates a control directory with a control file and scripts .TP -.B ob-buildopk(1) -Pack binary package files into an opk file. -.sp -Generally executed by package -.I build -files. +.BR ob-buildopk (1) +Pack binary package files into an opk file .SH ENVIRONMENT VARIABLES -opkbuild makes available to package -.IR config and build -files and other opkhelper tools a number of environment variables that describe -the packages being built, the build and host systems, and the toolchain to be -used. The difference between "build" and "host" systems follows the convention -set by GNU Autoconf. The build system is the one on which software is built. -The host system is the one on which software is to be run. For more information, see -.IR https://www.gnu.org/software/autoconf/manual/autoconf.html#Specifying-Targe\ -t-Triplets . +.BR opkbuild (1) +makes available to other opkbuild tools and package +.B build +files a number of environment variables that describe the packages being built, +the build and host systems, and the toolchain to be used. The difference +between "build" and "host" systems follows the convention set by GNU Autoconf. +The build system is the one on which software is built. The host system is the +one on which software is to be run. For more information, see <\fIhttps://www.\ +gnu.org/software/autoconf/manual/html_node/Specifying-Target-Triplets.html\fP>. .SS PACKAGE .TP -.B OH_SOURCE +.B OPK_SOURCE The source package name .TP -.B OH_SOURCE_VERSION +.B OPK_SOURCE_VERSION The source package version .TP -.B OH_SOURCE_VERSION_UPSTREAM +.B OPK_SOURCE_VERSION_UPSTREAM The upstream source package version (which may include a Software Inclusion Policy revision number) .TP -.B OH_BINARY_VERSION +.B OPK_BINARY_VERSION The binary package version (which is different from -.B OH_SOURCE_VERSION +.B OPK_SOURCE_VERSION during a binary rebuild) .SS BUILD AND HOST SYSTEMS .TP -.B OH_BUILD_ARCH +.B OPK_BUILD_ARCH Build system distribution architecture string .TP -.B OH_BUILD_ARCH_CPU +.B OPK_BUILD_ARCH_CPU Build system CPU .TP -.B OH_BUILD_ARCH_KERNEL +.B OPK_BUILD_ARCH_KERNEL Build system kernel .TP -.B OH_BUILD_ARCH_LIBS +.B OPK_BUILD_ARCH_LIBS Build system C/C++ libraries .TP -.B OH_BUILD_PLATFORM -Build system application platform -.TP -.B OH_BUILD_ARCH_GNU +.B OPK_BUILD_ARCH_GNU Build system GNU system type .TP -.B OH_BUILD_ARCH_KBUILD -Build system kbuild srchitecture name -.sp -This is deprecated. +.B OPK_BUILD_PLAT +Build system application platform .TP -.B OH_HOST_ARCH +.B OPK_HOST_ARCH Host system distribution architecture string .TP -.B OH_HOST_ARCH_CPU +.B OPK_HOST_ARCH_CPU Host system CPU .TP -.B OH_HOST_ARCH_KERNEL +.B OPK_HOST_ARCH_KERNEL Host system kernel .TP -.B OH_HOST_ARCH_LIBS +.B OPK_HOST_ARCH_LIBS Host system C/C++ libraries .TP -.B OH_HOST_PLATFORM -Host system application platform -.TP -.B OH_HOST_ARCH_GNU +.B OPK_HOST_ARCH_GNU Host system GNU system type .TP -.B OH_HOST_ARCH_KBUILD -Host system kbuild srchitecture name -.sp -This is deprecated. -.TP -.B ARCH -Host system architecture name as used by kbuild. -.sp -This is deprecated. +.B OPK_HOST_PLAT +Host system application platform .SS TOOLS .TP @@ -213,14 +150,9 @@ This is deprecated. .TP .B STRIP "strip" with cross toolchain prefix -.TP -.B CROSS_COMPILE -Cross toolchain prefix as used by kbuild. -.sp -This is deprecated. .SH COPYRIGHT -Copyright (C) 2012 Patrick McDermott +Copyright (C) 2012, 2019 Patrick McDermott .sp This file is part of opkbuild. .sp -- cgit v0.9.1