mirror of
https://github.com/moparisthebest/pacman
synced 2024-08-13 17:03:46 -04:00
b0ae59724e
Especially when maintaining local templates in addition to the ones stored in /usr/share/makepkg-template, it can be useful to include templates stored in multiple different locations into one PKGBUILD. This patch makes this possible by allowing --template-dir to be specified multiple times. This also introduces a dedicated error message when a template cannot be found, in contrast to the already existing "Couldn't detect version for template '%s'". If a template of the same name is present in more than one of the given directories, the last one always takes precedence. Neither the default behaviour without the option given, nor the handling of a single template dir is changed. Signed-off-by: Dominik Fischer <d.f.fischer@web.de> Signed-off-by: Florian Pritz <bluewind@xinu.at> Signed-off-by: Allan McRae <allan@archlinux.org>
122 lines
3.4 KiB
Plaintext
122 lines
3.4 KiB
Plaintext
/////
|
|
vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us:
|
|
/////
|
|
makepkg-template(1)
|
|
===================
|
|
|
|
Name
|
|
----
|
|
makepkg-template - package build templating utility
|
|
|
|
|
|
Synopsis
|
|
--------
|
|
'makepkg-template' [options]
|
|
|
|
|
|
Description
|
|
-----------
|
|
'makepkg-template' is a script to ease the work of maintaining multiple similar
|
|
PKGBUILDs. It allows you to move most of the code from the PKGBUILD into a
|
|
template file and uses markers to allow in-place updating of existing PKGBUILDs
|
|
if the template has been changed.
|
|
|
|
Template files can contain any code allowed in a PKGBUILD. You can think of
|
|
them like external files included with "." or "source", but they will be
|
|
inlined into the PKGBUILD by 'makepkg-template' so you do not depend on the
|
|
template file when building the package.
|
|
|
|
Markers are bash comments in the form of:
|
|
|
|
# template start; key=value; key2=value2; ...
|
|
|
|
and
|
|
|
|
# template end;
|
|
|
|
Currently used keys are: name (mandatory) and version. Template names are limited to
|
|
alphanumerics, "@", "+", ".", "-", and "_". Versions are limited to numbers and ".".
|
|
|
|
For initial creation there is a one line short cut which does not need an end marker:
|
|
|
|
# template input; key=value;
|
|
|
|
Using this short-cut will result in 'makepkg-template' replacing it with start
|
|
and end markers and the template code on the first run.
|
|
|
|
Template files should be stored in one directory and filenames should be
|
|
"$template_name-$version.template" with a symlink "$template_name.template"
|
|
pointing to the most recent template. If the version is not set in the marker,
|
|
'makepkg-template' will automatically use the most recent version of the
|
|
template, otherwise the specified version will be used. This allows for easier
|
|
verification of untrusted PKGBUILDs if the template is trusted. You verify the
|
|
non-template code and then use a command similar to this:
|
|
|
|
diff -u <(makepkg-template -o -) PKGBUILD
|
|
|
|
Template files may also contain markers leading to nested templates in the
|
|
resulting PKGBUILD. If you use markers in a template, please set the version
|
|
you used/tested with in the start/input marker so other people can properly
|
|
recreate from templates.
|
|
|
|
|
|
Options
|
|
-------
|
|
*-p, \--input* <build script>::
|
|
Read the package script `build script` instead of the default.
|
|
|
|
*-o, \--output* <build script>::
|
|
Write the updated file to `build script` instead of overwriting the input file.
|
|
|
|
*-n, \--newest*::
|
|
Always use the newest available template file.
|
|
|
|
*\--template-dir* <dir>::
|
|
Change the dir where we are looking for template files. This option may be
|
|
given multiple times in which case files found in directory given last will
|
|
take precedence.
|
|
|
|
|
|
Example PKGBUILD
|
|
----------------
|
|
|
|
pkgname=perl-config-simple
|
|
pkgver=4.58
|
|
pkgrel=1
|
|
pkgdesc="simple configuration file class"
|
|
arch=('any')
|
|
license=('PerlArtistic' 'GPL')
|
|
depends=('perl')
|
|
source=("http://search.cpan.org/CPAN/authors/id/S/SH/SHERZODR/Config-Simple-${pkgver}.tar.gz")
|
|
md5sums=('f014aec54f0a1e2e880d317180fce502')
|
|
_distname="Config-Simple"
|
|
|
|
# template start; name=perl-module; version=1.0;
|
|
_distdir="${_distname}-${pkgver}"
|
|
url="https://metacpan.org/release/${_distname}"
|
|
options+=('!emptydirs')
|
|
|
|
build() {
|
|
cd "$srcdir/$_distdir"
|
|
perl Makefile.PL INSTALLDIRS=vendor
|
|
make
|
|
}
|
|
|
|
check() {
|
|
cd "$srcdir/$_distdir"
|
|
make test
|
|
}
|
|
|
|
package() {
|
|
cd "$srcdir/$_distdir"
|
|
make DESTDIR="$pkgdir" install
|
|
}
|
|
# template end;
|
|
|
|
|
|
See Also
|
|
--------
|
|
linkman:makepkg[8], linkman:PKGBUILD[5]
|
|
|
|
include::footer.txt[]
|